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1 . INTRODUCTION 

The Maintenance Interface (M.I.) Diagnostic is intended for use 

by the CE and manufacturing in testing the maintenance interface 

(M.I.). It is also available to the customer combined with the 
Cold Load Self Test diagnostic. 

The M.I. Diagnostic includes a linker program which is automati- 
cally loaded into console memory at address !C000 and is then 
followed by the remote console program at 1C100. The M I. diag- 
nostic is then loaded at address !C800. Note that in this 
manual, the symbol "!" denotes hexadecimal. The M.I. Diagnostic 
is written in 8080 microprocessor assembly language. 

When the diagnostic completes, it will issue a system reset and 
leave the CPU in micro run and program halt. 

1.1 MAINTENANCE INTERFACE OVERVIEW 

The M.I. is not a smart device and therefore its operation is 
under direct control of the system console and the CPU. 

The M.I. may be viewed as a set of thirty 8-bit functional 
registers that are accessed through a central data path by either 
the system console or the CPU. All functions provided by the 
M.I. result from the manipulation of these addressable registers. 
Some functions require combinations of registers and some regis- 
ters control a combination of functions. For further information 
on the M.I., refer to the HP 3000/30/33 Reference Training 
Manual, Section VII. 



1.2 REQUIRED HARDWARE 

• HP 3000/30/33 System Console 

• HP 3000/30/33 Computer System with 128K bytes of memory (the 
CPU must be able to execute microinstructions). 

1.3 REQUIRED SOFTWARE 

The Maintenance Interface diagnostic must be properly recorded on 
a Terminal Data cartridge tape that can be accessed by the HP 
3000/30/33 console. 
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Maintenance Interface Diagnostic 

1.4 HESS AGES AND PROMPTS 

Four types of messages are output by the diagnostic: information, 
error, error communication, and prompt messages. 

1.40 INFORMATION MESSAGES (i.e., title and end-of-pass) will be 
displayed with no program pause. 

1.41 ERROR MESSAGES are used to inform the operator when the 
system responds unexpectedly to a given stimulus. Error messages 
will begin with "**ERROR DETECTED IN STEP xx" (where xx is the 
step number in which the error occured). Then the text of the 
error message is output. The following is an example of an error 
message : 

••ERROR DETECTED IN STEP 20 

1MB DATA REGISTERS TEST FAILED. 

STATUS READ !A0 REGUO WROTE! 37 STATUS READ !A0 
REG123 WROTEU0 REGI24 WROTEtll REG125 READ ! 27 
EXPECTED TO READ 123 

Note that in the standard mode of operation (see Section 2) only 
the first 2 lines are output. In the optional mode of operation, 
the entire message is output. The error messages supply the 
following information: 

1) The number of the step which failed. 

2) A general description of the failure. 

3) The register numbers involved in the test. 

4) Data written to and read from the registers. 

5) The expected data. 

In the standard operating mode the diagnostic is set to pause if 
an error is detected. After the error message is output, the 
following message is also output: 

CONTINUE (Y OR N>? 

If *N* is entered, the diagnostic is aborted. 

1.42 COMMUNICATION ERROR MESSAGES are printed whenever communi- 
cation with the M.I. fail. If this type of failure is inter- 
mittent, a communication error could occur during any of the 
tests. 

1.43 PROMPT MESSAGES are output whenever the program requires 
input from the operator (i.e., whether or not to suppress the 
pause after an error message is output). A complete explanation 
of prompt messages during program operation is covered in Section 
2. 

NOTE 

For a complete explanation and summary of all error 
messages refer to Section 5 of this manual. 

1-2 



1.5 DIAGNOSTIC LIMITATIONS 

No software can be run fo v the CPU while the M.I* diagnostic is 
being run. 

The H.I. diagnostic can test the internals of the Maintenance 
Interface PCA with a high degree of accuracy. Note, however, the 
interfaces to the rest of the system cannot be fully tested. In 
particular, the diagnostic cannot test some failures which could 
cause the Maintenance Interface's 1MB interface to interfere with 
normal 1MB traffic. Also, the CPU interface is not tested at the 
speed of the CPU. Intermittent errors may not be detected. 

The M.I. /HP-IB interface is not tested. The primary reason for 
this is that the diagnostic does not have access to the HP IB 
side of the interface, and, consequently, cannot tell when this 
interface is working. 

Note that the M.I. /HP-IB interface is utilized in the Cold Load 
Self-Test. Therefore, passage of this diagnostic and the failure 
of the Cold Load Self-Test may point to an M.I. failure. 

1.6 MINI-OPERATING INSTRUCTIONS 

1. Perform an MPE SHUTDOWN. 

2. Run the console Self Test. 

3. Ensure the system in in Micro run and Program run. 

4. Fully reset the terminal via RESET TERMINAL key. 

5. Set the REMOTE key to its up position. 

6. Insert M.I. /Cold Load Self -Test cartridge and press READ 
when appropriate. 

7. Answer STANDARD TEST (Y OR N)? appropriately. 
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2. INTRODUCTION 

There are two modes of operation possible for the Maintenance 
Interface diagnostic; the standard mode and the optional mode. 
Following is the operating procedure for each mode. 

2. 1 STANDARD OPERATING MODE 

The M.I. diagnostic is stored on a Terminal Data cartridge tape. 
To load the diagnostic into the system console, perform the 
following steps: 

1. Perform an MPE SHUTDOWN to log everyone off the system in an 
orderly manner. 

2. Run the console Self Test by pressing the TEST key on the 
keyboard. Verify the displayed output. 

3. Fully reset the console by pressing the RESET TERMINAL key 
twice. An inverse video status line is displayed at the top 
of the screen. It should indicate a RUN or HALT condition. 

4. Set the REMOTE key on the console keyboard to its up position 
so that the console will be in local mode. 

5. Insert the maintenance interface diagnostic tape into the 
left cartridge console tape drive. The tape will automati- 
cally rewind to its beginning. 

6. Depress the READ key on the console. The term LOADING is 
output immediately and then the following title message and 
question. 

MAINTENANCE INTERFACE DIAGNOSTIC VERSION MX. XX 
STANDARD TEST (Y OR N)? 

7. To cause the diagnostic to run once and halt on error (i.e., 
standard model, enter "Y cr". 

If no errors are detected, the diagnostic completes its operation 
in 60 seconds by outputting the following message to the console: 
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END OF DIAGNOSTIC - NO ERRORS DETECTED 

If an error is detected during execution, an error message is 
output and the diagnostic completes by outputting the following 
message: 

END OF DIAGNOSTIC - REPLACE THE MAINTENANCE INTERFACE 

NOTE 

The diagnostic can be stopped at any time by 
depressing any key while the diagnostic is 
running. The diagnostic then prints the CONTINUE 
(Y OR N) question. Entering "N" causes the diag- 
nostic to be aborted. 



2.2 OPTIONAL OPERATING MODE 

To enter the optional operating mode, perform steps 1 through 7 
of the standard operating procedure. Then, to allow special 
options to be chosen, enter "N" in response to the STANDARD TEST 
question in step 7. As soon as "N" is entered, the following 
question is output to the console: 

LOOP (Y OR N)? 

The loop option causes the entire diagnostic to loop. When set 
to loop (i.e., you enter *Y* to the LOOP questions), the diag- 
nostic will print 'PASS xxx" (where xxx is the pass number) at 
the end of each loop through the diagnostic. 

Once you have answered the LOOP question, the following question 
is immediately output: 

SUPPRESS HALT (Y OR N)? 

If you wish to eliminate the CONTINUE message and halt, enter "Y" 
to the SUPPRESS HALT message. Every time an error is detected, 
an error message is output (as described in Sections 1 and 5} and 
the message "CONTINUE (Y OR N)?". 

Once you have answered the SUPPRESS HALT question the diagnostic 
begins its execution. 

NOTE 

The diagnostic can be stopped at any time by 
depressing any key while the diagnostic is 
running. The diagnostic then prints the CON- 
TINUE (Y OR N) question. Entering "N" causes 
the diagnostic to be aborted. 
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2.3 M.I. STATE AFTER DIAGNOSTIC EXECUTION 

Upon sucessful completion of the diagnostic, the state of the MI 
and CPU will be as follows: 

• The CPU will be set to program halt and micro run. 

• The CPU will be set on internal clock. 

• 1MB timeouts will be enabled. 

• All breakpoints will be disabled; including 1MB, ROM, and DSH 
breakpoints. 

• The 1MB interface on the Maintenance Interface PCA will be 
disabled. 

• The front panel function register (!0D) on the M.I. PCA will 
be set to zero (0). 

• The most significant byte of the CPU communications register 
(!16) will be set to !88 to indicate that the CPU communi- 
cations is inactive. 

• A system reset will be issued. 

If errors are detected during execution, the diagnostic will try 
to set the M.I. PCA and the CPU to the state described above, but 
may be unsuccessful. 



I'MilHMJ 



If a full terminal reset is performed while the diag- 
nostic is executing, the diagnostic is aborted and the 
state of the M.I. PCA and the CPU will be unknown. In 
this case, it is very likely that the M.I. PCA and CPU 
will be in a state which will prevent the system from 
performing a "cold load" or "warm start". If this 
occurs, cycle power on and off on the processor. 
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The Maintenance Interface diagnostic takes less than 1 minute 
run for a single pass. 



to 
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4.0 INTRODUCTION 

The following is a description of each test that is performed by 
the Maintenance Interface Diagnostic. Also included is the error 
message that will be output should an error occur in that par- 
ticular step. 

If an M.I. communication error occurs during any step, that mes- 
sage will also be output along with the error message. 

Note that a summary of error messages, generated by each step, 
and the appropriate action to be taken can be found in Section 5 
of this manual. 

TEST DESCRIPTION 

1 This test sends interface clear and device clear to the 
M.I. If the M.I. cannot be initialized in this manner, 
the following error message is output: 

INITIALIZE MI TEST FAILED 

Faults could be in the console, the HP-IB cable to the 
M.I., or in the M.I. itself. A communication error 
will also be printed. See Section 5. 

NOTE: This test will pass if the cable to M.I. is 
disconnected. It only checks to make sure the HP-IB to 
the M.I. is not "hung". 

2 This test repeatedly reads status from the M.I. and 
examines the status for gross errors. The following 
error message is output to the console should the 
status be in error: 

READ STATUS TEST FAILED 

This error could be caused by failures in the M.I. 
PCA's HP-IB interface to the console (to I/O junction 
panel) or the HP-IB cable (from the I/O junction panel) 
to the M.I. could be disconnected. This can also be 
caused by a power supply failure in the mainframe. 

Sometimes the status cannot be read and sometimes in 
can be read. In this instance, the above message is 
output plus the following addition: 
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TEST DESCRIPTION 

INTERMITTENT 

Somtimes the status is incorrect and other times it is 
correct. In this instance, the above message is output 
plus the following addition: 

BAD DATA READ 

3 This test gets and releases control of the Maintenance 
Interface. Should an error occur during this step it 
usually indicates a failure in the M.I. HP-IB interface 
to the console. The error message is: 

GET/RELEASE MI TEST FAILED 

Also, if the diagnostic cannot get control or cannot 
release control of the M.I., one of the following 
messages may be appended to the above error message: 

GET MI FAILED 
CAN'T RELEASE MI 

4 This test determines whether the special front panel 
console keys (numeric pad) are disabled or not. These 
console keys can be disabled via a switch on the front 
panel being set to NO. A NO condition discovered, 
causes the diagnostic to abort. The diagnostic is 
aborted in this instance because ther is a strong 
possibility that the MPE operating system is active 
(usually signified by this group of keys being dis- 
abled). The M.I. should not run simultaneously with 
MPE as catestrophic errors can occur. 

TESTS ABORTED - CONSOLE KEYS ARE DISABLED 

5 This test first disables the breakpoints. Then the 
test checks to. make sure the run/halt flip-flop, in the 
CPU, can be set to micro run and micro halt. It also 
checks the status from the M.I. to verify that the HALT 
and MICROHALT bits are accurate. 

When the CPU cannot be set to micro halt, micro run, 
program halt, or program run, the following error 
message is output to the system console: 

MICROHALT-PROGRAM HALT TEST FAILED 

The status displayed along with this message will 
indicate exactly which function cannot be performed. 
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TEST DESCRIPTION 

6 This test writes a unique pattern to most of the H.I. 
registers and then reads the values back while com- 
paring the data written to the data read. 

When the registers cannot be correctly set, the fol- 
lowing error message is output to the console: 

REGISTER INITIALIZATION TEST FAILED 

The register last accessed is the register which could 
not be initialized. The value expected to be read will 
also be printed. The problem could be in the register 
last accessed or in the addressing logic on the H.I. 
PCA. 

7-10 These tests write patterns to most of the M.I. regis- 
ters and then they read from the registers. Step 7 
tests registers !0 to !7. Step 8 tests registers !8 to 
!F. Step 9 tests registers U0 to 117. Step 10 tests 
registers !18 to !1F. 

The following message inidcates that the last register 
accessed did not respond as expected. The value read 
and expected indicates which bit of the register res- 
ponded improperly: 

REGISTER PATTERN TEST FAILED 

11 This test exercises the controls of the 1MB such as 
priority out and bus request, as well as all the ad- 
dress, data, and handshake drivers and receivers. If 
an error occurs during the exercise, the followng 
message is output: 

1MB INTERFACE TEST FAILED 

Additional messages will be printed to more fully de- 
scribe the error. These messages are as follows: 

NO BUS ACK. 

Bus acknowledge was not received. This tends to indi- 
cate that the 1MB is being held by some other device. 



4-3 



Maintenance Interface Diagnostic 

TEST DESCRIPTION 

1MB IN USE 

Some other device is using the 1MB. This tends -o 
indicate that some defective device is holding the 1.13. 

DATA DRIVERS 

It is possible the 1MB data drivers (registers IDE > id 
!0F) are not operating properly. Maybe that drivers 
cannot be enabled by ENDAT in register 118. 

ADDRESS DOIT OR WAIT 

One or more of the signals enabled by ENDO in register 
!18 are not working. The signals enabled by EtlDO are 
the address and opcode lines plus address DO-IT (ADO), 
DATA DCHIT (DDO), and WAIT. 

DONE OR PARITY 

One or more of the signals enabled by ENDN in register 
!18 cannot be set on the 1MB. These signals are ADN, 
DDN, DNV, and IMBPER. 

AUTOPRO FAILED 

Automatic priority out failed. 

AUTOTRM FAILED 

The automatic termination of an 1MB transfer failed. 

12 In this test patterns are written to the CPU communi- 
cations register (116) and then the status is checked 
to verify that the MSGIN and MSGOUT bits of status are 
working. 

When an error occurs in this process, the following 
message is output to the console: 

STATUS MESSAGE BITS TEST FAILED 

The error message will be accompanied by a dump of the 
last values read from and written to the M.I. The last 
operation will be a read from the M.I. which returned 
an unexpected value. The value expected will also be 
displayed. 



4-4 



Maintenance Interface Diagnostic 

TEST DESCRIPTION 

13 The M.I. will either not issue a system reset or will 
not respond to a system reset if the following message 
is output. 

SYSTEM RESET TEST FAILED 

14 This test checks the half step function and verifies 
that the CPU clock can be frozen in both the high and 
low state. 

The following message is output should an error occur: 

CPU MICROSTEP TEST FAILED 

15 This test checks the ROM instruction register drivers 
and recievers on the M.I. The following message is 
output in case of error: 

RIR TEST FAILED 

16 In this test, the M.I. forces the CPU to execute jump 
long microinstructions to several addresses and then 
verifies that the M.I. reads the address correctly. 
The following message is output in case of error: 

RAR TEST FAILED 

One of the following messages is also output as further 
description of the failure: 

PRESTROBE FAILED 

The prestrobe function of registers !3 and 14 on the 
M.I. is not working correctly. 

NO STEP 

The CPU did not execute the jump long microinstruction. 

TOO MANY STEPS 

The CPU executed many instructions when it was re- 
quested to perform only one. 

RECEIVER FAILED 

The CPU executed the jump long microinstruction but the 
M.I. cannot correctly read the RAR. 
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17 This test forces the H.I. to request a cold load. The 
the CPU is forced to read external register 1 to see if 
a cold load message got to the CPU. 

A failure in this test causes the following message to 
be output to the console: 

LOAD TEST FAILED 

Possible causes are hardware failure in M.I., back- 
plane, system front panel and its cables, or the CPU. 
No cold load is actually performed. 

18 This test is identical to the LOAD test except that a 
dump is requested. As with the LOAD test, failues of 
this test could be caused by hardware failures in the 
H.I., backplane, the system front panel or its cables, 
or the CPU. No dump is actually performed. The 
following message is output when an error occurs: 

DUMP TEST FAILED 

19 This test forces the CPU to execute microinstructions 
to change the pause indicator. The error could indi- 
cate failures in the M.I.'s CPU interface or in the 
pause hardware on the N.I. The following message is 
output in case of error: 

PAUSE INDICATOR TEST FAILED 

The following messages are additional message that may 
occur to further explain the error condition: 

CAN NOT RESET 

The pause bit cannot be set to 0. 

CAN NOT SET 

The pause bit cannot be set to 1. 

CAN NOT TOGGLE 

The pause bit cannot be toggled from a 1 to a or from 
a to 1. 
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20 This test exercises the DSW breakpoint logic and indi- 
cators. If an error is detected, the following message 
is output: 

DSW BP TEST FAILED 

One of the following messages may also be output for 
further explanation: 

DSWl-3 BAD 

One or more of the DSW indicator bits in H.I. register 
! IF does not respond properly. 

CAN HOT DISABLE 

A DSW breakpoint cannot be disabled by bit 2 in M.I. 
register ! ID. 

CAN NOT ENABLE 

A DSW breakpoint cannot be enabled or the CPU fails to 
micro halt. 

21 This test writes patterns into the M.I.'s ROM address 
register and also into the breakpoint compare regis- 
ters. Then the rom breakpoint (ROMBP) indicator is 
checked to make sure that it indicates when the break- 
point address matches the ROM address and a ROM break- 
point is enabled. 

If an error is detected, then one of the following 
messages will be printed. 

ROM BP DETECT TEST FAILED 

CAN NOT DISABLE 

The ROM breakpoint indicator in M.I. register !1F is 
set even though the ROM breakpoint is disabled. 

CAN NOT ENABLE 

The ROM breakpoint indicator is not set as expected 
when the addresses are equal. This could be caused by 
the ROM breakpoint failing to be enabled. 
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EXTRA COMPARE 

The ROM breakpoint indicator indicates that the break- 
point address matches the ROM address when the 
addresses are different. 

NO COMPARE 

The ROM breakpoint indicator indicates that a break- 
point address does not match the ROM address when they 
do match. 

22 This test verifies that when a ROM breakpoint is de- 
tected, the CPU is microhalted and when the ROM break- 
point is disabled, the CPU is not microhalted. 

The following message is output should this test fail: 

ROM BP HALT TEST FAILED 

23 This test first gets control of the 1MB. If this step 
is unseccessful, then either 'NO BUS ACK' or '1MB IN 
USE' will be printed (see step 11). This test writes 
addresses onto the 1MB and writes corresponding 
patterns into the breakpoint compare registers with 1MB 
breakpoints enabled. Then the 1MB breakpoint indi- 
cator, in register iiF, is checked to determine whether 
a breakpoint occurred. If the compare is bad, one of 
the following message is output to the console. 

1MB BP COMPARE TEST FAILED 

The breakpoint logic of the M.I. is not functioning 
properly. Replace the M.I. 

EXTRA COMPARE 

If this message is appended to the above message, a 
breakpoint occurred when the breakpoint compare address 
did not match the 1MB address. 

NO COMPARE 

If this message is appended to the 1MB BP COMPARE 
message, a breakpoint did not occur when the breakpoint 
compare address did match the 1MB address. 
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DESCRIPTION 



24 This test checks several different functions of the 1MB 
breakpoint logic of the M.I. The test gets control of 
the 1MB and may print 'NO BUS ACK' or '1MB IN USE' if 
it cannot get control (see step 11). If an error 
occurs after control of the 1MB is accomplished, the 
following message is output to the system console. 

1MB BP FUNCTIONS TEST FAILED 



There is a problem with the M.I. 
Replace the M.I. 



breakpoint logic. 



CAN NOT DISABLE 



If this message is appended to the 
1MB breakpoint cannot be disabled. 



above message, an 



CAN NOT ENABLE 

If this message is appended to the 1MB BP FUNCTIONS 
message, an 1MB breakpoint cannot be enabled. 

WRITE BP ON READ 

If appended to 1MB BP FUNCTIONS message, this indicates 
that when a write only breakpoint was set, a memory 
read operation triggered the breakpoint. 

NO READ BP 

If appended to 1MB BP FUNCTIONS message, a breakpoint 
does not occur on a memory read operation when 
read/write breakpoints are enabled. 

NO WRITE BP 

If appended to 1MB BP FUNCTIONS message, a breakpoint 
does not occur when a write breakpoint was set and a 
write operation was performed. 

BP ON I/O 

If appended to 1MB BP FUNCTIONS message, a breakpoint 
occurs on an I/O operation when it should only occur 
for a memory operation. 
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ADO 

If appended to 1MB BP FUNCTIONS message, a breakpoint 
occurs even if ADO is not set on the 1KB. 

25 This test checks the FREEZE bit in the M.I. register !0 
to verifiy that a breakpoint will either set IRQ or 
microhalt the CPU. If the test cannot use the 1MB, 
then 'NO BUS ACK' or '1MB IN USE' will be printed on 
the system console (see step 11). If this test fails 
the following message is output to the console along 
with one of the other messages that follow. 

1MB BP HALT TEST FAILED 

Replace the M.I. 

NO HALT 

If this message is appended to the 1MB BP HALT message, 
the breakpoint should have halted the CPU but did not. 

BAD IRQ 

If appended to the 1MB BP HALT message, the breakpoint 
was set to microhalt the CPU but it also set IRQ on the 
1MB. 

NO IRQ 

If appended to the 1MB BP HALT message, an IRQ on the 
1MB did not occur as expected. 

BAD HALT 

If appended to the 1MB BP HALT message, a microhalt 
occurred when an IRQ should have been issued instead. 
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5.0 INTRODUCTION 

Throughout this manual explanation for errors, their cause, and 
possible action to be taken have been interspersed with the ap- 
propriate test description. The purpose of this section is to 
summarize this information for easier reference. 

Table 5-1. Error/Action Summary 



I MESSAGE 


| FAILURE 


ACTION | 


(COMMUNICATION ERROR 


| Console cannot analyze 


Perform console | 




I the error. Possible 


self-test or re- | 




I console failure 


place M.I. HP-IB | 


I | STEP-ALL | 


1 


interface cable I 


I CPU MICROSTEP TEST 


ICannot freeze CPU 


Replace M.I. first! 


I FAILED 


| clock high or low 

1 

1 


If same error oc- | 
curs perform CPU | 
self-test or re- 1 


I |STEP-14 | 


1 


place BIC PCA | 


|DSW BP TEST FAILED 


I Breakpoint logic 


Replace M.I. I 




I failed 


or replace CPU I 


IDSW1-3 BAD 


|1 or more DSW indica- 
tor bits in MI reg. 1 IF 
I does not respond OK 


1 


ICAN NOT DISABLE 


| DSW breakpoint cannot 
(be disabled 




{CAN NOT ENABLE 


| DSW breakpoint cannot 
|be enabled or CPU 




I ISTEP-20 | 


| fails to microhalt 




jDUMP TEST FAILED 


I Request to dump failed 


Replace M.I. firstl 




|to get to CPU 

1 

1 

1 


then check front | 
panel, then verify! 
CPU, and, finally, | 
verify cables and | 


I ISTEP-18 I 


1 


1MB components | 


|GET MI FAILED 


I Console cannot gain 


Replace MI | 


| | STEP«ALL | 


I control of MI 




I GET/RELEASE MI TEST 


ICannot get or release 


Replace MI or re- | 


(FAILED 


I control of MI 


place MI HP-IB | 


1 ISTEP-3 | 


1 


interface cable I 
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FAILURE 


ACTION 


GET STATUS FAILED 


MI did not respond to 
status byte request 


Replace MI 


I STEP-ALL | 


from console 




1MB BP COMPARE TEST 


M.I. breakpoint logic 


Replace M.I. 


FAILED 


not working 




EXTRA COMPARE 


BP occurred and BP 
address did not com- 
pare with 1MB address 




NO COMPARE 


BP did not occur and 
BP address and 1MB ad- 




ISTEP-23 I 


dress do match. 




1MB BP FUNCTIONS TEST 


M.I. breakpoint logic 


Replace M.I. 


FAILED 


in not working 




CAN NOT DISABLE 


1MB BP cannot be dis- 
abled. 




CAN DOT ENABLE 


1MB BP cannot be en- 
abled. 




WRITE BP ON READ 


Memory read operation 
triggered write only 
breakpoint 




NO READ BP 


Read/write BP enabled 
does not cause BP to 
occur on Memory read 




NO WRITE BP 


Write BP enabled does 
not cause breakpoint 
during write operation 




BP ON I/O 


Breakpoint should not 
occur in I/O operation 




ADO 


Breakpoint occurs even 




ISTEP-24 | 


if ADO is not set 




IMP BP HALT TEST FAILED 


M.I. FREEZE logic bad 


Replace M.I. 


NO HALT 


BP did not halt CPU 




BAD IRQ 


BP set to microhalt 
CPU but it also set 
IRQ on 1MB 




BAD HALT 


Microhalt occurred and 
only IRQ should 've 




|STEP-25 | 



been issued 
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I __ 

1 1MB INTERFACE TEST 

| FAILED 

| NO BUS ACK. 

I 
I 
1 1MB IN USE 

I 

| DATA DRIVERS 



| ADDRESS DOIT OR WAIT 
I 

| DONE OR PARITY 

I 
I 
IAUTOPRO FAILED 



IAUTOTRM FAILED 
| |STEP=11 I 



FAILURE 



ACTION 



| 1MB controls failed I 



Bus acknowledge not 1 Check *« active 
recieved [device holding 1MB 



|rec 



| Check for defec- 



Some other device is icheoc lor «■««- 
I using 1MB Itive device on 1MB 

IData drivers ( !0E, ! OF) | Replace MI 

I not operating properly I 

I I 

IENDO signals not work- | Replace MI 

ling in reg. !18 of MI I 

IENDN signals not work- 1 Replace MI 
ling in reg. 118 of MI I 

I Automatic priority out | Replace MI 

| failed J 

I I 

I Automatic termination I Replace MI 

|of 1MB transfer failedl 



| INITIALIZE MI TEST 
| FAILED 



'1 Diagnostic cannot ini-'|Run console self 
Itialize M.I. | test or check for 



| STEP-1 



| faulty cable to 
| M.I. or Replace i 



I- 



| LOAD TEST FAILED 



I 



Request to load f ailedlReplace M;I. 
I to get to CPU I then check for 



first 



1 



1STEP-17 I 



shorts on backplan 
| then verify front 
I panel and cables 
I finally verify CPU 



MlcR^Tl^plM-H^riC^annot be set to l"^.^^!-* 



I TEST FAILED 



|nicrohalt,microrun, ! then .^« C lL I , rpn 
iprogram halt, or pro- possible bad CPU 

ISTEP-5 I I ^am "»__■_ j 



| NON-RESPONDING MI 
j | STEP-ALL | 



I MI not accepting HP-IB|Replace M.I. 
I commands from console 1 
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MESSAGE 



FAILURE | ACTION 



PAUSE INDICATOR TEST 
FAILED 



CAN NOT RESET 
CAN NOT SET 



UnillV in MI ' S CPU I Replace h.i! 

I interface or in pause I 

I hardware on M.I. i 

I | 

I Pause cannot be set | 



I 

I Pause bit cannot be 

I set to 1 



CAN NOT TOGGLE 

ISTEP-19 | i tailed 



I Pause bit cannot be | 



RAR TEST FAILED 

PRESTROBE FAILED 
NO STEP 

TOO MANY STEPS 



RECEIVER FAILED 
ISTEP-16 I 



I CPU jump long micro- | 
(instructions cannot be l 
[read by M.I. j 

I 



Iprestrobe function on 
IN. I. not working 
I 

I CPU didn't execute 
I jump long microin- 
istruction 
I 

I To aany instructions 
I executed by CPU 
! 

I M.I. cannot read in- 
struction correctly j 



(Replace M.I. 

I 

I 

IVerify operation 

I of CPU 



IVerify CPU operat 

lion 

I 

I Replace H.I. 



READ FAILED 

I STEP-ALL I 



|M 



■I- 



.rt-J; K i f"' t trans£er IReplace M.I. 
Idata byte requested by| 
I console 



READ STATUS TEST FAILEDJGross error tZZZT^ZlZZTnto 

jwhen diagnostic reads |face from M.I. " 



INTERMITTENT 



BAD DATA READ 
I STEP-2 | 



IM.I. status 

I 
I 



I Some times status can- 

|not be read 

I 

I Status read is some- 

I times incorrect 



I console or cable 
I to M.I. is discon- 
nected. Secondly 
I check for power 
I failure 



I 
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MESSAGE 



FAILURE 



ACTION 



REGISTER INITIALIZATION | Data pattern written 
TEST FAILED Ithen read from H.I. 



|STEP=6 | 



I registers does not 
I compare 



-I- 

I Last register accessed 
|d id not respond as 
lexpected 



Replace M.I. 



REGISTER PATTERN TEST 
FAILED 

|STEP*7-10| 



Replace M.I. 



RIR TEST FAILED 



|STEP=15 | 



I ROM Instructions Reg- 
lister drivers and/or 
Ireceivers on M.I. not 
Iworking properly 



Replace M.I. 



-I- 



ROM BP DETECT TEST 
FAILED 



CAN NOT DISABLE 



CAN NOT ENABLE 



EXTRA COMPARE 



I Breakpoint address 
I (ROM) does not match 
ROM address and/or a 
ROM breakpoint not 
enabled 

ROM Breakpoint indica- 
tor is set though ROM 
breakpoint is disabled 

ROM breakpoint indica- 
tor is not set and 
should be set 

ROM indicator says 
breakpoint address 
matches ROM address 
when they're different 



Replace M. I. 



NO COMPARE 



|STEP=21 



I ROM BP indicator says 
I breakpoint addres does 
I not match ROM address 
I when they do match 



, 

ROM BP HALT TEST FAILED | CPU does not respond 
I to breakpoint enable/ 
ISTEP-22 | Idisable 



Replace M.I. 
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MESSAGE I FAILURE I ACTION 

STATUS MESSAGE BITS I Status of CPU communi-| Replace M.I. 
TEST FAILED Ications register^ !16) | 

I has error in MSGIN and| 

|STEP=12 | IMSGOUT bits I 

1 1 

SYSTEM RESET TEST I M.I. will not respond | Replace M.I. 
FAILED I to system reset nor I 

|STEP»13 | lissure a system reset | 

1 1 

TESTS ABORTED - C0NSOLE| Possiblity that MPE islMake sure that HPE 
KEYS ARE DISABLED Irunning due to consolelis not running and 

I keys being disabled | enable console 

|STEP»4 | I I keys 
1 1 



5-6 



GLOSSARY 



VI 



6.0 INTRODUCTION 

The following terras and abbreviations are used in the manual. 



TERM 
ADN 
ADO 
AUTOPRO 

AUTOTRM 

BRQ 
CPU 
DDH 

DDO 
DNV 
DSW 



EN DAT 



MEANING IN THIS DOCUMENT 

Address done. This is a handshake line on the 1MB. 

Address do-it. This is a handshake line on the 1MB. 

This is a capability of the M.I. which allows the 
M.I. to automatically set priority out when bus 
request is received from another device. 

This is a capability of the M.I. which allows the 
M.I. to automatically terminate a transfer from the 
M.I. to another device over the 1MB when the other 
device signals that it has received the data. 

Bus request. A handshake line on the 1MB used by a 
device requesting access to the 1MB. 



Central Processor Unit. In this document it 
to the 2 board HP 3000/25 CPU. 



refers 



ENDN 



Data Done. This is one of the handshake signals for 
data on the 1MB. 

Data do-it. This is one of the handshake signals 
for data on the 1MB. 

Data Not Valid. This is one of the handshake sig- 
nals for data on the 1MB. 

Data Switch. This is an instruction which can be 
placed in the ABUS field of a CPU microinstruction 
to request that a microhalt occur. This raicrohalt 
is not performed by the CPU but is performed by the 
M.I. if a DSW breakpoint is enabled. 

This is a bit in M.I. register !18 which enables the 
M.I. 's data drivers onto the 1MB. 

This is a bit in the M.I. register !18 which enables 
the M.I. 's ADN, DDN, DNV, and IMBPER signals onto the 
1MB. 
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ENDO This is a bit in M.I. register !18 which enables the 
M. I. 's address, ADO, DDO, and WAIT signals onto the 
1MB. 

IMBPER 1MB parity error. This is a signal on the 1MB 
indicating that a memory parity error has occurred. 

IRQ Interrupt request. This is a line on the 1MB used 

by an interrupting device to notify the CPU. 

M.I. The Maintenance Interface PCA in the HP 3000/25. 

RAJR The ROM Address Register in the CPU. 

RIR The ROM Instruction Register in the CPU. 
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GENERAL INFORMATION 



tO INTRODUCTION 

The Cold Load Self-test program is designed tc check the subset 
of the HP 3000/30/33 hardware that is used when a "cold load" 
operation is performed. 

There are eleven (11) test sections of the Cold Load Self-test 
program. These test sections, briefly, are: 

CPU Processor Board Tests 

1. Test to set RAR to %10000 

2. PCU Chip Test 

3. RALU Chip Test 

4. RASS Chip Test 
System Module Testing 

5. BIC (Bus Interface Controller) board test 

6. ROM CRC (CPU - PCB) Chip Test (20 chips) 
ROM CRC (Firmware - PCB) Chip Test (8 chips) 

7. Memory Test (128K bytes) 

8. GIC Board Test 

9. ID test of cold load device 

10. Write/Read Loopback Test (device controller) 

11. ADCC Board Test 

Each of the eleven test sections can be broken down into several 
steps. When the program is executing any one of the sections, a 
message to that effect is displayed on the screen of the system 
console. When an error is detected, the sequence of testing 

pauses, and an error message is displayed on the screen. Program 
execution may be continued by typing GO and pressing return. To 
terminate execution, type "EX cr". This will clean all registers 
and flags, and restart microrun. 

Testing will always run from the start of the entire program to 
the end of the program (if no errors are detected). 
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11 REQUIRED HARDWARE 

The minimum system configuration assumed is shown in Figure 1-1. 
All tests require that this system configuration be present. 
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Figure 1-1. System Architecture for Cold Load Self-Test 



The system console is always connected to ADCC channel 1 as 
device number 0. 
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The Cold Load Self-test program assumes that the system console 
and the Maintenance Interface board are functional. Therefore, 
it is important that these modules be tested prior to execution 
of this program. The testing of these two modules is described 
in the following documents: 

• The Reference Training Manual (Section on 2649 System 
Console) 

• Maintenance Interface Diagnostic Manual 

12 SOFTWARE REQUIREMENTS 

The only software required is the Cold Load Self-test program, 
properly recorded on a Terminal Data Cartridge, that can be 
accessed by the HP 3000/30/33 system console. 

13 MESSAGES AND PROMPTS 

when the program is first loaded, it displays its title message 
and prompt (>). You are asked to enter "GO" at the system 

console. From this point on no further input is required. The 
program will then output either information messages pertaining 
to each test section, or, error messages, should they occur. 

When an error message is output, the program pauses and then 
displays the following messages: 

TO RESTART PUSH RESET TERMINAL 

TO CONTINUE TYPE "GO" 

TO EXIT TYPE "EX" 

NOTE 

Every execution should be completed by entering the 
"EX" command to avoid problems with the next process 
(i.e.. Loading MPE, etc.). 
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14 DIAGNOSTIC LIMITATIONS 

The following are not included in this diagnostic program: 

• There is no Read Self Test. 

• ROM parity checking is done in Test Section 6. If an error 
occurs, one message is output to indicate that a ROM chip is 
bad. Refer to manual Section 4 for more information. 

15 MINI-OPERATING INSTRUCTIONS 

1. Set COLD LOAD thumbwheels to cold load device you wish to 
test - make sure they match physical device settings and 
device number of cold load device is not 7. 

2. Appropriately place the system in Micro Run/Progam halt. 

3. Ensure that the HP-IB test cable is properly connected to 
I/O channel selected by the COLD LOAD switch. 

4. Place REMOTE key in LOCAL, CAPS LOCK key in down position. 

5. Insert cartridge that contains Cold Load Self-Test and 
press READ twice to execute just Cold Load Self-Test. 

6. Answer all question appropriately to begin execution. 
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U INTRODUCTION 

Before executing the Cold load Self-test be sure that the system 
console and the Maintenance Interface module are functioning 
properly. To do this perforin the self test for the console and 
execute the Maintenance Interface diagnostic. If either one of 
these modules are operating incorrectly, the Cold Load Self-test 
will not be valid. 

2.1 COLO LOAD SELF-TEST LOADING PROCEDURE 

1. If MPE is running, perform an MPE SHUTDOWN to properly logoff 
all current sessions. 

2. Set the COLD LOAD thumbwheel switches to the Cold Load device 
you want to test. Refer to the following table for settings: 



COLD LOAD 
DEVICE 



7902/9895 



Magnetic 

Tape 



system disc 



CHANNEL 



DEVICE 
CONTROLLER 



NOTE: The front panel switches and the channel/ device 
controller switches must match. 

3. Place the REMOTE key in its up position and the CAPS LOCK key 
in its down position. 

4. Fully reset the console by rapidly pressing the RESET 
TERMINAL key twice. 

5. Insert the cartridge tape that has the Maintenance Interface 
diagnostic and the Cold Load Self-Test in the left slot 
(default) of the system console. If you are forced to use 
the right side make sure the console is set to read from this 
side (refer to the fteferer.ce Training manual fcr 
instr uct ions) . 
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6. Press the READ key on the console. The M.I. Diagnostic is 
loaded first. If you do not want to run the M.I. Diagnostic, 
press the READ key twice to only load the Cold Load self 
test. The following message will be output to the system 
console. 

LOADING COLD LOAD SELF TEST 

Then, after the program is loaded, the following instruction 
and prompt (>) are output: 

COLD LOAD SELF TEST 

VERSION x.xx - MM/DD/7Y 

TO START TEST TYPE "GO" RETURN 

> 

7. Enter "GO cr " (where cr » RETURN key). The console will 
start the test. If anything besides "GO cr " is entered, the 
"TO START TEST TYPE GO" message is repeated. 

When testing is started, the message "COLD LOAD SELF TEST 
STARTED" is output to the console. 

Once testing has started, no further action is required from the 
operator and all tests will be run. The console will update the 
screen to indicate which test is being performed at any given 
time. Refer to sections 4 and S for explanations of all messages. 

When an error is detected, testing will pause and an error mes- 
sage will be displayed on the system console. 

Z2 RESTARTING OR CONTINUING COLO LOAD SELF TEST 

To restart the Cold Load Self-Test, press RESET TERMINAL one time 
only and follow the instructions described in 2.1.7. To continue 
execution after an error message has been displayed, type "GO cr " 
and the program will continue. 

13. SYSTEM STATE AFTER COLD LOAD SELF TEST EXECUTION 

The execution should have been completed by entering "EX". Then, 
whether an error occured or not, the Cold Load Self-Test leaves 
system hardware in a state that allows the loading and execution 
of either the MPE operating system or the Diagnostic Utility 
System. 
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The Cold Load Self-Test program takes approximately 
from the beginning of testing to completion. 



80 seconds 



As each test section begins, the program outputs a message to the 
console which includes the approximate amount of time that that 
particular test section will take. Also, the time is included in 
the step messages output as each step is completed within a 
particular test section. 
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TEST DESCRIPTIONS 



IV 



4.0 INTRODUCTION 

This section describes each test section and all steps associated 
with it. There will also be test data paths shown and expanded 
troubleshooting guides given where applicable. 

4.1 TEST SECTION 1 

This test verifies that the RAR can be set to the address 117777 
(to ensure that all bits can be set) then that it can be set to 
address %10000 (where % means octal). Address %10000 is the 
starting address for the self test section of microcode. To set 
the RAR, the CPU processor board must be able to execute a JMPL 
microinstruction to location %10000. To accomplish this, the 
following steps are performed via the Maintenance Interface PCA. 

NOTE 

The M.I. does not use any of the system busses for this 
test. The M.I. has direct control of the registers RIR 
and RAR. 

1. The CPU is microhalted 

2. A 32 bit microinstruction is entered into the external RIR of 

the CPU. 

3. The CPU is then enabled to microstep. 

4. After the microstep in step 3 (above), the CPU RAR (ROM 
address register) should be at %10000. 

5. The RAR is then read and compared against the correct value. 

If the RAR is NOT correct, the problem is most likely the CPU 
processor board or the BIC board. The error message is displayed 
as follows: 

RAR IN ERROR 

Also output will be the value that was supposed to be set and 
what was actually read from the RAR. 

If the test passes no message is displayed and testing continues. 
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4.2 TEST SECTIONS 2-7 

These test sections are actually the subdivision of the hardwired 
CPU self test steps (10 through 64). The code for these test 
steps resides in ROM on the CPU processor PCA. The test steps 
must be executed via the following mode: 

1. A ROM breakpoint is set on the M.I. This breakpoint is the 
address of the next sequential test to be executed [the first 
address being %10000). 

2. The RAR (ROM Address Register J is set to the start of the 
test to be executed. 

3. A microrun command is issued to the CPU via the M.I. 

4. The self-test control portion goes into a wait loop for 1 or 
more seconds. The time is determined by the test being exe- 
cuted. 

5. At the end of the WAIT loop the status of the CPU is examined 
by the M.I. 

If the test was successful (test executed is test that RAR was 
set to), the CPU will be halted at the breakpoint that was set in 
step 1 above. If the test was NOT successful, then the CPU will 
be in one of the following states; 

• The CPU will be halted at an error trap location. 

• The CPU will be halted but not at the correct location. 

• The CPU will not be halted at all. This is the condition 
where the CPU is executing some code, but there is no way of 
determining what that code is. 

For example: Test 1 on the CPU processor board starts at RDM 
location 110013. The next sequential test will start at location 
%10055. The RAR is set to U0013 (start of test) and the ROM 
breakpoint is set to %10055 (start of the next sequential test). 
The following sequence of events would occur: 

1. The CPU would be issued a command to microrun via the M.I. 

2. The program would wait for 1 or more seconds depending on the 
execution time of the test. 

3. The program would then monitor the status of the CPU and 
breakpoint registers via the M.I. 

If the CPU is halted at the correct breakpoint then a 
successful completion of the test which starts at location 
%10013 would be indicated. 
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4. The program would then set the ROM breakpoint to the address 
of the next test and repeat the process in steps 1 through 3. 

If the CPU was in any of the error states, then a failure is 
indicated and an error message output to the console. 

These error messages will indicate which step of a particular 
test section failed. The following paragraphs describe the steps 
within each test section, the possible error conditions, and the 
action to be taken. 

4.20 Tut Stction 2 - PCU Tndag 

The following test steps verify the proper operation of the PCU 
portion of the CPU processor board. 

STEP DESCRIPTION 

10 TAV, TBV and the STACK bit are verified for proper 
operation. 

11 SKIP on immediate, DBUS, INDR, and LINK are 
verified. 

12 AV, BV, SAVEA, SAVEB, JMP, JMPL, JSB, and RSB are 
verified for proper operation. 

13 CIR, MAPPER, ATTN are verified for proper 
operation. 

Should any of the above test steps fail, the following error 
message is output to the console: 

PCU TESTtxx FAIL 

where xx equals the step number. A failure in these steps 
indicates a problem with the CPU processoror its connector ; and 
in particular the PCU portion of this board. The action to be 
taken is presented below in the order of probable cause. 

1. Swap in a new CPU processor board. 

2. Swap in a New BIC board (Steps 10-13 also check some hardware 
on the BIC board) . 

3. Remove PCU chip, clean connector pins and return it. 
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121 Twt SKtiM 3 - RAUI T«tM| 

The following test steps verify the proper operation of the RALU 
portion of the CPU processor board. 

STEP DESCRIPTION 

14 The RALU registers are checked for proper 
operation. 

15 The RALU extended registers are checked for proper 
operation. 

16 The ALU (arithmetic logic unit) is verified. 

1 7 The arithmetic shifting logic is tested along with 
the linking logic. 

NOTE 

During test step 15, the extended address lines E4-E1 
are exercised and may be observed with a logic probe to 
determine if they are still low or high. 

Should any of the above steps fail, the following error message 
is output to the console: 

RALU TESTtex FAIL 

where xx equals the step number. A failure in these steps 
indicates a problem with the CPU processor board; and in 
particular the RALU chip and associated logic. The action to be 
taken is presented below in the order of most probable cause. 

1. Replace the entire CPU processor board 

2. Replace the BIC board (Some hardware checking is done on the 
BIC board in these test steps) . 

3. Remove RALU chip, clean connector pins and return it. 

122 Tot SMtiM 4 - RASS Testa* 

The following test steps verify proper operation of the RASS por- 
tion of the CPU processor board. 

STEP DESCRIPTION 

20 The RASS Counter register and the Status register 
(bits and 3) are verified for proper operation. 

21 The Interrupt Status register (bits 10-13), the 
Bounds Violation logic, the Comparator, and Atten- 
tion are checked for proper operation of the over- 
flow and underflow function. 
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22 The Pte-adder logic and the Special Current In- 
struction Register (CIR) are verified. 

23 The RASS registers are exercised and verfied. 

24 The RASS Status register (bits 4-7) are verified 
for proper operation. 

Should any of the above steps fail, the following error message 
is output to the console: 

RASS TESTtxx FAIL 

where xx equals the step number. A failure in these steps 
indicates a problem in the CPU proccessor board; and particularly 
the RASS chip logic. The action to be taken is presented below 
in the order of most probable cause. 

1. Replace the CPU processor board. 

2. Replace the BIC board (some hardware checking is done to the 
BIC board in the above tests) . 

3. Remove RASS chip, clean connector pins and return it. 

4.23 Test Section 5 - BIC Testing 

The following test steps verify proper operation of the BIC 

board. 

STEP DESCRIPTION 

25 The Interrupt Status register (bits 2-6,8,9,14, and 
15) , the skip-on-test logic, the internal sync 
register, and Attention are verified for proper 
operation. 

26 The CPU DOIT and DONE command logic, the time out 
logic, and the fleet state of the 1MB are tested 
for proper operation. 

27 The Freeze logic is tested for proper operation. 

Should any of the above steps fail, the following error message 
is output to the console: 

BIC TESTtxx FAIL 

where xx equals the step number. A failure in these steps indi- 
cates a problem on the BIC board. The action to be taken is pre- 
sented below in the order of most probable cause. 
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1. Replace the BIC board 

2. Replace the CPU processor board (there is much interdepen- 
dence between the BIC and the CPU processor) 

3. Special action should be taken if step 26 fails because this 
is the first test to check the float state of the 1MB 
(Inter-Module- Bus) . To discover if an 1MB data line is 
"stuck" at a low voltage level, perform the following proce- 
dure: 

a. Power down the system 

b. Pull all channel and memory boards out of the backplane 

c. Power up the system 

d. Load and execute the Cold Load Self Test again 

If, after removing all channel and memory boards, step 26 passes, 
probably an 1MB data driver on a channel or memory board is de- 
fective (shorted to ground); Re-install each board one at a time 
and run the Cold Load Self-Test each time you install a board 
until the test fails again. In this instance you have isolated a 
bad channel or memory board. 

4. If step 26 still fails confer with your system specialist. 

4.24 Tact SsctiM 6 - Cental Stan CftC Tactiaa. 

The steps in this test section verifiy each ROM chip on the CPU 
processor and firmware boards (i.e., each parity code that is 
burned into a ROM chip is compared against the parity actually 
found) . 

Please note that one test step is executed per ROM chip. 

When any step fails, one of the CRC test message lists the loca- 
tion of the faulty chip with the PCB name: 

ROM CRC (CPU PROC-PCB) TEST tan FAILED Chip Location Uxxx 
ROM CRC (FIRMWARE -PCB) TEST tnnn FAILED Chip Location Uxxx 

The following method may also be used to determine chip location: 

1. Go to the rear of the system and open the door . 

2. Locate the BIC PCA and the ten (10) LEDs near the top of the 
board. 
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The lowest LED (*), next to the CPU TEST switch should be 
lighted. The upper nine (9) LEDs shouid be displaying the 

test step number of the ROM that failed in octal- The first 
9 LEDs are read from top to bottom. The table below lists 
the step number, the LED pattern in octal, and the ROM chip # 
being tested. It also tells the number of optional XXX PROM 
ROW(s) checked. This number should be at least 002 and pos- 
sibly more if additional microcode is installed at some later 
date. Check the label on the stiffener bar of firmware board 
to see how many rows are installed. 



Er r or * 


ROM 


Error* 


ROM 


Error* 


ROM 






Processor Board 






30(300) 
31(310) 
32(320) 
33(330) 


U-131 
0-141 
0-151 
0-161 


40(400) 
41(410) 
42(420) 
43(430) 


U-133 
0-143 
U-153 
U-163 


50(500) 
51(510) 
52(520) 
53(530) 


U-135 
U-145 
U-155 
0-16 5 


34(340) 
35(350) 
36(360) 
37 (370) 


0-132 
0-14 2 
0-152 
0-162 


44(440) 
45(4 50) 
46(460) 
47(470) 

Firmware 


U-134 
U-14 4 
U-154 
0-16 4 

Board 


54(540) 
55(550) 
56(560) 
57(570) 


U-136 
U-146 
0-156 
U-166 


100(001) 
101(011) 
102(021) 
103(031) 


U-23 
U-33 
U-73 
U-83 


104 (041) 
105(051) 
106(061) 
107(071) 


U-93 
U-103 
U-123 
U-133 


110(101) 
111(111) 
112(121) 
113( 131) 


U-24 
U-34 
0-74 
U-8 4 


114( 141) 
115( 151) 
116 ( 161) 
117(171) 


U-94 
O-10 4 
U-124 
0-134 


120(201) 
121(211) 
122(221) 
123(231) 


U-25 
U-35 
U-75 
U-85 


124(241) 
125(251) 
126(261) 
127(271) 


U-95 
0-105 
U-125 
U-135 


130(301) 
131(311) 
132(321) 
133(331) 


0-27 
0-37 
U-77 
0-87 


134(341 
135(351) 
136 (361) 
137(371) 


U-97 
O-107 
0-12 7 
U-137 






* Notation is shewn f 
Example: 100(011) 


or contents of NI R and LED display. 
= NIR(LED display), in octal. 
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4.26 Twt 

The following test steps verify the memory controller handshake 
along the 1MB path to the NIR, and, the lower 128K bytes of mem- 
ory (area of memory used by the Cold Load process). 

STEP DESCRIPTION 

60 This is the first step to use the 1MB handshake 
lines. The test is designed to read the status of 
the memory controller board; so there may be other 
faults on this board other than the handshake 
lines. 

61 This test is designed to check all 1MB data lines 
for array number 4 of the lower 128K bytes of mem- 
ory (00,140000 to 00,177777) . 

62 This test is designed to check all 1MB data lines 
for array number 3 of the lower 128K bytes of mem- 
ory (00,100000 to 00,137777). 

63 This test is designed to check all 1MB data lines 
for array number 2 of the lower 128K bytes of mem- 
ory (00,040000 to 00,077777). 

64 This test is designed to check all 1MB data lines 
and address lines for array number 1 of the lower 
lower 64K of memory (00,000000 to 00,037777). 

If step 60 fails, the following message is output to the console: 

MEMORY CONTROLLER FAIL 

Since this is the first time the 1MB handshake lines are used, 

there is a possibility that one or more of the lines may be stuck 

high or low. To gain more information, the following may be 
per formed : 

1. Replace Memory Controller board and restart test. 

2. If test still fails, remove all channel boards and restart 
the Cold Load Self Test. 

3. If the test passes, then a channel board is loading down the 
1MB handshake lines. Replace boards one at a time until bad 
board is discovered. 

4. If the test fails with all channel boards removed, replace 
the BIC. 

5. If the test still fails, then a handshake line is shorted in 
the 1MB backplane. In this instance, confer with your system 
specialist. 
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Should steps 61, 62, 63, or 64 fail, the following error message 
is output to the console: 

MEMORY TEST #x x FAILED 

where xx equals the test step number. The Memory Array PCA #0 
has possibly a bad bit. To determine this for sure, perform the 
following steps: 



1. 



Replace the Memory Array PCA #0 with the highest # 'd array 
and run test again. 



2. If test still fails, replace the memory controller board. 

3. If test fails again, remove all channel boards and run test 
again. 

4. If the test passes, then a channel board is loading down the 
1MB handshake lines. Replace boards one at a time until bad 
board is discovered. 

5. If the test fails with all channel boards removed, replace 
BIC and re-run test. 

6. If the test still fails, then a handshake line is shorted and 
you should confer with your system specialist. 

4.28 Tort Section 2-7 CoMptatt WMmrt Enw 

The following message is output to the system console if no fail- 
ures occured in test sections 2 through 7. 

CPU AND MEMORY TEST COMPLETE NO ERRORS 

This message indicates that the following subset of hardware in 
the HP 3000/33 system is functional: 

• CPU processor board 

• Firmware board 

• BIC board 

• 1MB backplane 

• Memory Controller PCA 

• Lower 64K words of memory 
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4.3 COMMON ERROR MESSA6ES FOR TEST SECTIONS V7 

In addition to the standard error messages that are printed, 
there are three error messages that might occur when executing 
test sections 1 through 7. 

RAR IN ERROR 

This indicates that the RAR cannot be set correctly. Refer to 
test section 1 for a more detailed explanation of this error. 

ERROR - CPU WILL NOT HALT 

This indicates that after the CPU was initially set to microrun, 
it never halted. The control program will wait for 8 seconds and 
then check the HALT status of the CPU. If the CPU is not halted 
then this error message will be displayed. Replace the CPU 
processor board. 

CPU NOT HALTED AT BREAKPOINT 

Output only for the first breakpoint set. This error indicates 
that the CPU is in the mictfohalt mode and it never reached the 
first breakpoint that was set. 

If either of the last two error messages are encountered, then 
either the BIC board is defective or the CPU processor board is 
defective. 

4.4 TEST SECTION I - GIC TESTING 

In this test section, the channel/device number is read from the 
switch register and checked for their validity (i.e., channel ♦ 
<> 0) . 

Error messages are issued when an illegal number occurs. This 
process is as follows: 

This preliminary step reads the channel and device number from 
the switch register via the following sequence of events: 

V 

• Check the channel number. I f OK pass control to step 65. 

• If in error, the following message is output with a pause 
(error if channel ■ or >15) . 
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NO COLD LOAD CHANNEL OR EQUAL 0, Correct conditions and RESTART 
Test 

The operator should fix the problem and restart the execution 
of the Cold Load Self-Test. 

Then steps 65 through 73 are executed to verify all GIC control 
functions, data transfer, service requests and interrupts. These 
steps are described below: 

STEP DESCRIPTION 

65 This test verifies the GIC configuration at 
the 1MB through the following sequence of 
events: 

• Checks that bit of GIC register 14 is 
reset and that bits 12 through 15 are set. 
If the test passes, control is transferred 
to step 66. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #65 FAILED - No GIC in Configuration 

66 This test verifies data communication between 
the MI and GIC registers 3,4,5,7,8 (lower byte 
only) and 9 and 10 (upper and lower bytes) 
through the following sequence: 

• Writes all 1 's and then all 's to the 
selected registers. The registers are read 
after each write and compared with inputted 
values. If the test passes, control is 
transferred to step 67. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #66 FAILED- GIC Register is Bad 

67 This test verifies DNV (Data Not Valid) 
through the following sequence: 

• Executes an ADD microinstruction to simu- 
late DNV and checks for skip. If test 
passes, control is transferred to step 70. 
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STEP DESCRIPTION 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #67 FAILED - DNV Accepted as Data 

70 This step tests CSRQ (Channel Service Request) 
after SIOP is issued to the GIC through the 
1MB, via the following sequence: 

• Executes SIOP from the stack and checks 
skip in RAR. If the test passes, control is 
transferred to step 71. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #70 FAILED - No CSRQ After SIOP 

71 This step tests CSRQ from the PHI interrupt 
for all device numbers (0-7) via the following 
sequence of events: 

• Places channel numbers (which were read 
before step 65) into GIC register 3 and the 
device numbers into register 15. The an ADD 
microinstruction is executed to obtain 
CSRQ. If the test passes, control is trans- 
ferred to step 72. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST 171 FAILED - No CSRQ from PHI Interrupt 

72 This test verifies operation of the GIC inter- 
rupt logic and IRQ (Interrupt Request) from 
every device number (0-7) through the follow- 
ing sequence of events: 

• Initializes selected GIC and executes a 
sequence of microcode instructions to 
obtain IRQ. If the test passes, control 
transferred to step 73. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #72 FAILED - No GIC Interrupt from COLD 
LOAD Device Channel 
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STEP DESCRIPTION 

73 This test verifies CSRQ from DMA circuitry, 

PHI, and FIFOs via the following sequence of 
events: 

• Writes 8 words into memory through the 
inbound FIFO and DMA circuitry. The words 
are read back to obtain CSBQ from DMA, PHI, 
and outbound FIFO. The results are compared 
to check proper data flow. If the test 
passes, control is transferred to ID test. 

• If an error occurs, the following message 
is output followed by a pause: 

TEST #73 FAILED - No CSRQ from DMA, PHI or 
IN/OUT FIFO 



4.40 AMitienal Eim Miiii|ii for 6IC Testing 



The following error conditions can occur throughout the GIC test- 
ing or as a result of operator error. 

CAN'T GET CONTROL OF 1MB FROM M/I 

This indicates that the 1MB did not respond to a request from the 
M.I. to have control. Any I/O board could be in control of the 

1MB. 

To gain more information, remove all I/O boards except the GIC 

for the cold load device (7902 for HP 3000/33) . If the error 

message still appears, after re-running the test, then the GIC, 
BIC, M.I., or Memory Controller could be defective. 

NO HANDSHAKE BETWEEN 1MB AND I/O BOAED 

This message is an indication that the GIC never responded to a 
handshake request from the 1MB. This usually happens when the 
front panel COLD LOAD channel number does not agree with the 
channel number that is set on the GIC. 

If these two numbers do agree, try changing them to another set 
of equal numbers. But, be sure that you do not set the channel 
number to any other valid channel number currently in use in the 
system. 

If this error still occurs, after running the test again, then 
either the GIC is defective or the front panel switches are de- 
fective or the M.I. could be defective. 

NO HANDSHAKE BETWEEN 1MB AND MEMORY 



511F-21 



COLD LOAD SELF TEST 

This message usually indicates that the handshake was never com- 
pleted when the M.I. was reading the DMA data in main memory. It 
is usually an indication that the memory controller is defective. 

4.5 TEST SECTION 9 - COLD LOAD DEVICE IDENTIFY 

In this test the ID number is requested from the device that is 
indicated by the thumbwheel settings on the front panel COLD LOAD 
switches. Therefore, in order to test a particular cold load 
device, you must first set the COLD LOAD thumbwheel switches to 
the channel and device number of that device. See Figure 4-4. 

The test actually looks at the settings and outputs the following 
message to let you know what it found: 

COLD LOAD CHANNEL/DEVICE NUMBER = ! 7/1 (For 7902) 

The test then requests the identification number of the indicated 
device and outputs the following message/result: 

ID NUMBER OF COLD LOAD DEVICE « !0081 (indicates 7902) 

It is up to you to evaluate whether the proper identification 
number was returned or not. 

The program is not capable of determining whether the correct ID 
number was returned. However, when no ID number is read, the 
following message is output: 

ID NUMBER OF COLD LOAD DEVICE - >FFFF < — NO RESPONSE 

The execution of test Section 9 is complete when one of the fol- 
lowing messages is output: 

IDENTIFY WITH COLD LOAD COMPLETED-NO ERRORS 
or, 

IDENTIFY WITH COLD LOAD COMPLETED 

The above message is output when no ID was read. 
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Figure 4-1. GIC Tests 65, 66 
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Fiaure 4-2. GIC T»ts 67, 70, 71, 72 
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Figure 4-3. GIC Test 73 
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Figure 4-4. Tect Cold Load Device Identity 
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4.6 TEST SECTION 10 - WRITE/READ LOOPBACK 

!5i'*f tion .verifies data transfer between a dC »n d - e 



ngure 



STEP 



DESCPIPTIOf 



1 The program creates the write buffer with 256 
bytes at address !20C in the memory bank 0. The 
byte sequence is: 

IFF, I 00, 101, !02, !FD, !FB; 

2 The program creates the read buffer with 256 byte- 
equal tc at address 1400 in the- memory bank 0. 

3 The prcgrair writes 256 bytes f r oir. write buffer 
DKi C and h the C G rc: Cller ° f "* ^ ^ d * Vice via 

4 The program reads 129 or 256 bytes from the Cold 
Load device controller into read buffer in the 
memory via the GIC and DMA fmction. The program 
then sets the size of the read count buffer 
automatically depending on the ID number; 129 
bytes for the magnetic tape, 256 bytes for all the 
other cold load controllers. 

5 The program compares the 129 or the 256 bytes 
(magnetic tape or all other controllers, respec- 
tively ) and issures one of two possible messaqes 
as shown below: 

WRITE/READ LCOPBACK TEST COKPLETED-NO ERRORS 
or, 

WRITE/READ LCOFEACK TEST FAILED 

in the instance of an error in the compare. 

Note that Test Section 10 takes 20 seconds to 
execute. 
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Figure 4-5. Test Write/Read Loopbsck 
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4.7 TEST SECTION 11 • ADCC TESTING 

In this test section, data is transferred to and from the ADCC, 
to ensure proper data transfer between the console and the ADCC. 

STEP DESCRIPTION 

1 This test step transmits data from the M.I., over 

the 1MB, through the ADCC (channel 1, device 0) to 
th« console. If the data is transferred 
correctly, the following message is output: 

ADCC TRANSMIT DATA PATH GOOD 

If the data is transferred incorrectly, one of the 
following messages is output to the console: 

NO HANDSHAKE BETWEEN 1MB AND I/O BOARD 

This message output, indicates that the M.I. sent 
a handshake signal to the ADCC channel (number 1), 
and the ADCC did not respond. The ADCC is 
probably defective. Before replacing the ADCC 

board, verify that the channel number is set to 1. 

ADCC TEST FAILED (TRANSMIT DATA ERROR) 

This message indicates that the following data 
path is defective : 

ADCC — >Connector (on ADCC) — >cable (terminal 
ports) — >Connector (terminal ports) — >cable 
(console) — > connector (console) 

The first matter to verify is that all cable con- 
nections are correct. If this is true, and the 
test still fails, then the ADCC is most likely 
defective. However, any hardware in this path 

could be the source of the malfunction. 

ADCC TEST FAILED (NO TRANSMIT DATA) 

This error message indicates that the console ne- 
ver received any start bits from the ADCC. Us- 
ually the cause of this error is the cabling being 
defective. However, the ADCC may also be defec- 
tive. 
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STEP DESCRIPTION 

5 This test step transmits data from the console, to 

the ADCC, over the 1MB, to the H.I. to ensure pro- 
per transmission over this data path. If the data 
is transferred correctly, the following message is 
output: 

ADCC RECEIVE DATA PATH GOOD 

If the data transfer is incorrect, the following 
error message could result: 

ADCC TEST FAILED (RECEIVE DATA ERROR) 

One of two possible messages can be output at the 
end of this test section: 

ADCC TEST COMPLETE-NO ERRORS 

or, 

ADCC TEST COMPLETE 

when at least one error was encountered. when 
this error message is output the following 
messages are also output: 

TO RESTART PUSH RESET TERMINAL 

TO CONTINUE TYPE "GO" 

TO EXIT TYPE "EX" 

The operator should select one of these options 
and properly respond. 

Upon succesful completion of self-test, the following message 
appears on the screen blinking: 

COLD LOAD SELF TEST COMPLETE 
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5.0 INTRODUCTION 

Throughout this manual explanation for errors, their cause, and 
possible action to be taken have been interspersed with the ap- 
propriate test description. The purpose of this section is to 
summarize this information for easier reference. 



Table 5-1. Error/Action Summary 



! MESSAGE 

IADCC TEST FAILED 
I (CONSOLE DEFECTIVE) 
I TEST SEC 11- STEP 4 
I- 

I 
I 
I 
I- 



FAILURE 



ACTION 



I Failure to empty con- Iconsole is defec- 
Isole buffer I tive 

I I 

-I- 



ADCC TEST FAILED (NO 
DATA TRANSMITTED) 
TEST SEC 11- STEP 4 

ADCC TEST FAILED 
(RECEIVE DATA) 
TEST SEC 11- STEP 5 

ADCC TEST FAILED 
(TRANSMIT DATA ERROR) 
TEST SEC 11- STEP 4 



. | 

IConsole never received I Check out cabling 

lany start bits from lor replace ADCC 

IADCC I 

| 1 

IADCC unable to receive I Replace ADCC 

I data I 

1 I 



I 
I 
I 
I 

IBIC TEST #XX FAIL 

I 

I I TEST SEC » 51 



I Data path from ADCC is 
idefective 

I 



IBIC functions defec- 
tive or the "float" 
Istate of 1MB is stuck 



I Verify cable con- 
nections or re- 
I replace ADCC 
.| 

I Replace BIC PCA 
lor replace CPU 
lor verify 1MB as 
lin Section 4 



I 

I CAN'T GET CONTROL OF 

I I MB FROM M/I 



I 



ITEST SEC 



81 



. | 

1 1MB didn't respond to 
I request for control 
I from M.I . 

I 
I 

I 



I COLD LOAD CHANNEL 
ICANNOT EQUAL CORRECT 
ICONDITION, RESTART 
| ITEST SEC « 81 



. | 

I Channel is reserved 
I for the BIC only 



.| 

I Verify if I/O 
Iboards are in 
lof 1MB. If not 

I replace GIC then 
IBIC, then M.I. , 

I I he n Memor y Co nt . 
-I- 



IVerify fron panel 
I COLD LOAD switch 
Isettings 
I 



■I- 
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MESSAGE 



I 



FAILURE 



ACTION 



COLD LOAD CHANNEL/ 
DEVICE NUMBER - Ix/x 



I TEST SEC 



91 



CPU NOT HALTED AT 
BREAKPOINT 

I TEST SECs-1-71 



DMA PATH FROM M/I TO 

MEMORY ID DEFECTIVE 

I TEST SEC - 81 



ERROR - CPU WILL NOT 
HALT 

I TEST SECs-1-71 

6IC TEST FAILED 



I STEP" 65-73 



DMA TEST FAILED 



ID NUMBER OF COLD LOAD 
DEVICE - Ixxxx 

ITEST SEC - 91 



MEMORY CONTROLLER FAIL 



I STEP -60 



Number output is the 
number found on the 
front panel COLD LOAD 
switches 



CPU in nicrohalt mode 
and never reached 

first breakpoint 



GIC cannot do DMA 
transfer 



Once CPU set to micro- 
run it won't halt 

Transmit data path be- 
tween M.I. and GIC is 
defective 



Transmit data path be- 
tween GIC and memory 
is defective 



Program outputs ID t 
after ID test to cold 
load device indicated 
in switch settings 



Memory Controller 
status incorrect 



You must verify 
correctness of 
number output, if 
incorrect check 
that switches on 
device and front 
panel match 



Replace BIC then 
CPU 



Replace GIC or 
M.I. 



Replace CPU 



Verify the M.I. 
HP -IB port and 
M.I. are talking 
If not replace MI 
or Replace GIC 
or verify that 
I/O PCA's are not 
holding 1MB lines 
as shown in sec- 
tion 4 of manual 

Verify HP-IB and 
1MB port. If not 
replace first 64K 
memory 



Verify ID t is 
correct for 
device indicated 
in switch setting 



Wsrify 1MB hand- 
shake line not 
holding 1MB and 
/or replace Mem- 
ory controller 
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MESSAGE 



ACTION 



IMEMORY TEST #XX FAILED 

I 

I ISTEPS = 61-64I 



I- 



Bad bit in Memory 
Array board #0 



I Replace Memory 
i or replace Memory 
I Controller 



-I ■ 



I NO HANDSHAKE BETWEEN 
I 1MB AND MEMORY 

i ITEST SEC = 81 



Handshake not com- 
pleted when M.I . was 
reading DMA data in 
main memory 



I Replace Memory 
IController PCA 



IPCU TEST #XX FAILED 
I ISTEPS 10-131 



CPU processor PCI) 
failure 



I Replace CPU 
I Replace BIC 



IRALU TEST #XX FAILED 
I |STEPS=14-17I 



CPU processor RALU 
chip failure 



I Replace CPU 
I Replace BIC 



IRAR IN ERROR 

I ISTEP = 1 



RAR cannot be set 
correctly 



I Replace CPU 
I Replace BIC 



IRASS TEST #XX FAILED 
i i STEPS = 20-24I 



CPU processor RASS 
chip failure 



I Replace CPU 
Replace BIC 



I 

I ROM CRC TEST #30-13 7 

IFAILED Chip Location 

IU23-U164 

I ST EPS = 30- 137 



•I- 



A ROM chip in the CPU 
or in firmware has 
failed 



I 

I ID NUMBER OF COLD LOAD 
I DEVICE » !FFFF-N0 
I RESPOND 



I Replace ROM Chip 
Ibeing tested by 
I that step 
I 
. | 



No ID number was read ICheck HP-IB cable 
I , proper set of 
ICHA/DEV #'s on 
Idevice and switch 
Iregister. Restart 



ITEST ABORTED 



Any eror in Sec. 1-7 IFix CPU, Restart 



-I- 

ICheck HP-IB cable 
Icha/dev number 
Ireplace cntrller 
lof cold load dev 



I WRITE READ LOOPBACK 
ITEST FAILED 



I 



Controller of cold 
load device failed. 
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MESSAGE 



I 

I 

I TEST 16 5 FAILED - NO 

IGIC IN CONFIGURATION 

I I TEST SEC = 81 

I 



FAILURE 



ACTION 



| 

I TEST #66 FAILED - GIC 
I REGISTER IS BAD 
I I TEST SEC = 81 



No response from any 
GIC 



Check the con- 
figuration and 
set proper 
channel number 



At least one of the 
GIC registers 3,4,5, 
7,8,9,10 failed 



Replace GIC 



ITEST #67 FAILED - DOT 

I ACCEPTED AS DATA 

I ITEST SEC = 81 

| 

ITEST #70 FAILED - NO 
ICSRQ FROM SIOP 
1 ITEST SEC * 81 



PHI failed 



Replace GIC 



PHI failed, no CSRQ 
from GIC 



Replace GIC 



! 

ITEST #71 FAILED - NO 

ICSBQ FROM PHI 

I INTERRUPT 

I ITEST SEC - 81 



PHI failed, no 
interrupt from GIC 



Replace GIC 



ITEST #72 FAILED - NO 
IGIC INTERRUPT FROM 
I COLD LOAD DEVICE 
I CHANNEL 
I ITEST SEC - 81 



No response from GIC 



Replace GIC 



ITEST #73 FAILED - NO 
ICSBQ FROM DMA, PHI, 
IOR IN/OUT FIFO'S 
I ITEST SEC - 81 

I 



At least one CSRQ 
failed to be received 
from DMA, PHI, or 
inbound or outbound 
FIFOs 



Replace GIC 
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6.0 INTRODUCTION 

The following terms and abbreviations are used in this manual. 



TERM 
ADCC 

BIC 

CPU 

CRC 

FIFO 



GIC 



1MB 



M.I . 



PCU 



RALU 



RAR 



MEANING IN THIS DOCUMENT 

Asyncronous Data Communications Controller which is 
the link between the CRT terminals and the system. 

Bus Interface Controller which is one of two boards 
that make up the CPU (Central Processing Unit). 

Central Processing Unit comprised of two boards 
located in the first card cage . 



Cyclic Redundency Check that insures all 
locations contain the correct information. 



ROM 



First In/Tirst Out register buffer of the Mainten- 
ance Interface board used for data transfers up to a 
maximum of 40 bytes. 

General Input/output Channel which is the link be- 
tween the peripheral devices and the system. 

Inter-Module-Bus; The central data and control path 
between the CPU, the memory, and the channels. It 
is an asynchronous handshake-controlled bus. 

Maintenance Interface board, a non- intellegent de- 
vice, provides the interconnection between the HP 
3000/33 and system console subsystem in order to 
provide maintenance panel and system self-test ca- 
pabilities. Refer to the HP 3000/33 Reference Train- 
ing Manual for further explanation. 

Processor Control Unit is a large scale integration 
(LSI) chip in the CPU. 

Register and Arithmetic-Logic Unit is a large scale 
integration (LSI) chip in the CPU. 

ROM Address Register 
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RASS Register Address-Skip-Special is a large scale 

integration (LSI) chip in the CPU. 

RIH. ROM Instruction Register 

SP5 Scratch Pad register number 5 located in the CPU. 
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General Information 



1.0 INTRODUCTION 

The Control and Maintenance Processor (CMP) Selftest Firmware 
performs tests on the CMP, CPU, Memory, System control Panel, 
ADCC at channel 1, and all GIC's present in the system. Some CPU 
testing is implemented through microcode resident in the CPU. 

Part of the microdiagnostics are automatically invoked at system 
power-up and the remainder by using the SELFTEST command. Also, 
during any COLD-LOAD or WARMSTART certain CPU selftests are per- 
formed. Use of the SEFLTEST command causes the CMP to self test 
its firmware and UART's and then the remainder of the system is 
tested. 

The CMP Power-On Selftest is executed whenever the CMP is powered 
up or the PON signal is momentarily held low. This test does not 
communicate with the CPU or use the 1MB and has a unique set of. 
error messages. 

When using the SELFTEST command, the CMP Selftest is executed by 
the CMP. It tests the CMP interfaces with the CPU, 1MB, ADCC, 
and System Control Panel. Some CMP Power-On tests are repeated 
during this test. 

The remainder of the System Selftest performs tests on the CMP- 
CPU interface, CPU, System Control Panel, ADCC, and GICs. Some 
of the CPU testing is implemented in CPU microcode. 
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1.1 REQUIRED HARDWARE 



The minimum system configuration required to run the CMP/SYSTEM 
Selftest is shown in Figure 1-1. 



SYSTEM 
CONTROL 

PANEL 



ITT I 




Figure 1-1. System Architecture for CMP/SYSTEM Selftest 
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2 . INTRODUCTION 

Before attempting to execute the CMP/SYSTEM Selftest, be sure the 
system/remote co isole is functioning properly. Perform the con- 
sole self test. 

If the system is running, only those sections of the system self- 
test that do not affect the CPU operation will be performed. If 
the system is halted, the entire selftest will be performed. 

2.1 CMP/SYSTEM SELFTEST OPERATING PROCEDURE 

a. If the system is running, perform an MPE SHUTDOWN to halt 
all current jobs/sessions and ensure the system will halt 
without damaging files on disc. 

b. You will receive a CMP prompt (->). Enter the SELFTEST 
command. The testing should begin. If testing does not 
begin, check the FUNCTION switch setting and if necessary 
set it to enable the CMP and re-enter the CMP "SELFTEST" 
command. 

A parameter may be used with the SELFTEST command. The parameter 
is a decimal number representing the following operations: 

PARAMETER OPERATION 

NUMBER 

(NONE) Perform SYSTEM SELFTEST excluding CMP RS-232 

loopback. 

Loop the entire SYSTEM SELFTEST excluding 

RS-232 loopback. 

2 Loop the RAM test. 

4 Loop the ROM test. 

6 Loop the UART test. 

8 Loop the CMP-CPU Interface test. 

10 Loop the CPU test. 

12 Loop the System Control Panel test. 
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14 Loop the ADCC test. 

16 Loop the GIC test. 

Looping will continue until the user types any character on the 
on the console or a failure in selftest is detected. To allow 
looping regardless of failure, set switch B8 on the CMP PCA front 
edge to the up (open) position. 

The following example shows the messages printed on the console 
when the SYSTEM SELFTEST runs successfully: 

->SELFTEST 
CMP TEST 
RAM test passed 
ROM test passed 
UART test passed 

CMP-CPU Interface 
SWITCH -00 
test passed 

CPU TEST 
0000 
0400 
0800 
0C00 
1000 
1400 
E000 
E400 
E800 
test passed 

CONTROL PANEL 
STATUS-06 SYS DISC»NORM 
test passed 

ADCC TRANSMIT test passed 

ADCC RECEIVE test passed 

GIC TEST CHL-05 test passed 

GIC TEST CHL-06 test passed 

SYSTEM TEST passed 
-> 
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3 . INTRODUCTION 

This section provides descriptions of each test section and their 
associated steps. Some figures are shown to graphically indicate 
which system components are involved in the various tests. 

Examples of error messages are given with each test section des- 
cription. 

NOTE: All test sections beyond the CMP Power-On selftest are 
part of SELFTEST (They require the use of the SELFTEST 
command ) . 

CMP selftest error messages are listed in Appendix A. 

3.1 CMP POWER-ON SELFTEST 

The CMP executes this test whenever it is reset by the PON signal 
or the CMP is powered up. This section of the selftest tests the 
internals of the CMP but does not affect the rest of the system. 
It does not communicate with the CPU or use the 1MB. It is in- 
tended to help diagnose failures in the LSI chips on the CMP and 
in the address decode and data buffer logic. (See figure 3-1.) 

If a serious error is detected, the CMP sets its interfaces to 
avoid interaction with other system components and becomes inac- 
tive. The System Control Panel can then be used for bringing up 
the system if the failure is localized to the CMP. The CMP may- 
removed without affecting front panel startups. 

The CMP user interface is designed to supply information to loc- 
alize a failure to one or two LSI chips. MSI and SSI chips are 
only tested as they relate to a specific function operation. 

Some failures on the CMP prevent the CMP from printing error mes- 
sages on the console. This can be caused by failure of the MC5, 
UARTs, ROMs, or address decoding and data buffers. To help in 
diagnosing these problems, the CMP has LEDs that help show the 
cause of the failure. 
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If the CMP does not communicate with the console, perform the 
following steps: 

a. Check the power indicator LEDs. 

The CMP requires +5, +12, and -12 volts to communicate 
with the console. It also uses +5M for some of the CMP 
RAM. If the power supply indicator LEDs indicate that 
one of these voltages is not present, replace the power 
supply . 

b. Check the four LEDs on the edge of the CMP. 

The bottom LED is lit when the microprocessor is properly 
handling timer interrupts. If this LED is not lit, the 
failure is preventing microprocessor operation. It could 
be a catastrophic failure in the MC5, RAMs, ROMs, or ad- 
dress decode and data buffering. 

The next to the bottom LED is lit when the CMP is receiv- 
ing the Data Terminal Ready signal from the console. If 
this LED is not lit, the failure is probably in CMP-to- 
console cabling. It could also be a failure in the con- 
sole or CMP RS-232 interfaces. In some cases the console 
may not supply a Data Terminal Ready signal or the cable 
might not have a wire to carry the DTR signal. 

The two uppermost LEDs are written to by the microproces- 
sor. If the microprocessor does not write to these LEDs, 
they will be lit. During Power-Up, the LEDs sequence 
through a flashing pattern, that ends with both LEDs lit. 
The upper LED combinations are interpreted as follows: 

00 Both LEDs off means that the microprocessor started 
the Power-On selftest, but could not complete it due 
to unexpected failures or multiple failures. 

01 Top LED off, next to top LED on. This indicates the 
timer on the CMP has failed. Either the timer never 
sets or it cannot be reset. 

10 Top LED on, next to top LED off. This indicates a 
failure in the UART on the CMP which connects to the 
console or in its related circuitry. 
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All error messages generated by the Power-On selftest are printed 
to the console at 2400 baud with no parity. They are of the form 
CMP FAILURE (error message). The (error message) information is 
described below. 

TIMER FAILED - This message indicates that the 10ms timer on 
the CMP never timed out. This error will pre- 
vent CMP operation. 

TIMER FAILED 1 - This message indicates that the 10ms timer on 
the CMP could not be reset. This error will 
prevent CMP operation. 

RAM X - This error indicates a RAM failure on the CMP. The RAM 
number (X) will be a digit from 1 to 4 and is interpreted 
as follows: 



Lower Memory, Upper Byte 

Lower Memory, Lower Byte 

Upper Memory, upper Byte 

Upper Memory, Lower Byte 

Lower Memory, Lower Byte 

Lower Memory, Lower Byte 

RAM ERROR MEMORY MAP 
ADDRESS MSB ERROR # LSB ERP.OR # 
000-3FF 1 2 

400-7FF 3 4 

ROM X - This error indicates a ROM or EPROM failure on the CMP. 
The ROM rvumber (X) will be 1 or 2 and is interpreted as 
follows: 

U# THAT FAILED 

0137,145,146 Upper Byte 

U37,17,47 Lower Byte 

U137,146 Upper Byte 

U37,47 Lower Byte 

3.2 

This test is executed by the CMP. It tests CMP interfaces with 
the CPU, 1MB, ADCC, and System Control Panel. (See figure 3-2.) 
The following paragraphs describe the sub-sections of the CMP 
TEST. 

RAM test: The RAM test performed is different than the CMP Power 

On RAM test and, ^ue to the algorithm, may get different results. 

The error parame ers are also different. The error messages and 
their meanings are: 



RAM # 


RAM SIZE 


U# Tl 


1 


8K 


U165 


2 


8K 


U67 


3 


8K 


U166 


4 


8K 


U87 


1,3 


16K 


U165 


2,4 


16K 


U67 



ROM # 


ROM SIZE 


I 




32K 


2 




32K 


1 




64K 


2 




64K 


CMP TEST 
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RAM 1 TEST FAILED This indicates that an error was detected in 

the upper eight bits of a data word. This 
indicates an error in U165 or U166. 

RAM 2 TEST FAILED This indicates that an error was detected in 

the lowereight bits of a data word. This 
indicates an error in U67 or U87. 



ROM test: This test is identical to the CMP Power-On ROM TEST. 
The error messages and their meanings are: 

ROM (x) This error indicates a ROM or EPROM failure on the CMP. 
The ROM number (x) will be 1 or 2 and is interpreted as follows: 

ROM# ROM SIZE U| THAT FAILED 

1 32K U137, 145, 146 upper byte 

2 32K U37, 17, 47 lower byte 

1 64K U137, 146 upper byte 

2 64K U37 47 lower byte 

UART test: This test uses the local loopback, function to test 
the UART that interfaces to the ADCC. This UART is also used in 
the ADCC loopback test. The UART that interfaces to the con- 
sole is not tested. 



3-4 



256Kb SMA'S 



nil. rn 



c 



MAG 
TAPE 



JUNCTION 
PANEL 



DISC 
CTLR 




AOCC 
MAIN 



12 3 




FRONT 
PANEL 



■ I MBW B MIM II IWai l Wnin'iMlj^ 





Figure 3-1. CMP Power-On Selftest 
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3.3 CMP-CPU INTERFACE TEST 



This test checks inter-communication between the CMP and CPU. 
(See figure 3-3.) Any error messages generated are of the form: 

ERROR IN STEP(#) (parm#l) (parm#2) 

Where (parm#l) and (parm#2) are optional. Generally, if 
parm#l and parm#2 are printed, parm#l is the expected 
value and parm#2 is the actual value. 

If the CPU is not present or is not functional, errors can occur 
in the following steps. The CMP cannot reliably distinguish CMP- 
CPU interface errors from CPU failures in many cases. 

The test steps are described below. 

STEP t STEP DESCRIPTION 

10 A system reset is issued. The CMP clears XR7 except for 
datacomm related bits, then reads XR7. If XR7 bits ABP, 
ROMBP, RUN, STOP, ENON, FDRON, STOPON, and PFWON are not 
zero, then an error message is printed and parmtl is the 
value of XR7 with all bits except those described above 
masked off. 

20 A system reset is issued. The CMP asserts MICROHALT, 
CMPFDR, CMPEN, and PFWEN by writing to XR7. Then, XR7 is 
read and STOP, FDRON, ENON, and PFWON are checked for be- 
ing true. If not all true, then XR7 with all bits except 
those above masked off is printed as parm#2 and the ex- 
pected value is printed as parmll. 

30 The CMP attempts to microstep the CPU by writing to XR6 . 
If SCON is true after attempting the microstep, then the 
microstep did not occur and an error message is printed. 

40 Data patterns are written to the lower 16 bits of the MIR 
with the CMP MIR drivers enabled. Then the MIR receivers 
are clocked by writing to XR6 and the MIR lines are read. 
If the data read does not match the data written, then an 
error message is printed, and parm#l is the expected data 
and parm#2 is the actual value read. Note that for the 
MIR receivers to be clocked ,the CPU clock (MQ) must be 
in its proper state. 

41 Same as step number 40 except this step is performed on 
the middle 16 bits of the MIR. 

42 Same as step number 40 except this step is performed on 
the upper 16 bits of the MIR. 
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50 With RDEN off, the CMP writes data to its MIR drivers and 
checks the data read off the MIR. If the test affected 
the MIR data (indicating RDEN failure) the error message 
is printed. This step tests the lower 16 bits of the MIR. 
The Exclusive OR of expected and actual data is printed 
as parmtl. 

51 Same as step number 50 except the middle 16 bits of the 
MIR are tested. 

52 Same as step number 50 except the upper 16 bits of the 
MIR are tested. 

70 The CMP issues a system reset to the CPU. The CSAR is 
set to a value of !AAAA and to 15555 by forcing several 
microinstructions, including a CSAR jump. Then, the CSAR 
receivers are clocked using XR6 and read to verify that 
the CSAR was set properly. If the test fails, the error 
message is printed and the expected and actual values of 
the CSAR are printed. 

80 The CMP forces CPU microinstructions to set the CPU UBUS. 
Then, the CPU UBUS is read using CMPFDR. If the expected 
and actual values of the CSAR lines differ, the error 
message is printed with parmtl being the expected value 
and parmt2 being the actual value read. The values at- 
tempted are !AAAA and then 15555. 

90 CPU NOP microinstructions are forced by the CMP while 
STOPBP is disabled. If a STOPON becomes set in XR7, the 
error message is printed. 

91 If, after step number 90 the GO line is being held low 
(indicated by the CPU's inability to microstep) the error 
message is printed. 

92 The CMP forces a microinstruction to the CPU with a STOP 
in the store field while the CMP STOPBP circuitry is en- 
abled. If a STOPON does not become set in XR7, the error 
message is printed. 

93 After step number 92 if GO is not being held low as indi- 
cated by the CPU'S ability to microstep, the error mess- 
age is printed. This indicates the inability of the 
STOPBP circuitry to assert GO-. 

94 STOPBP is turned off, then the STOPON indicator is check- 
ed. If STOPON is still true, an error has occurred and 
the error message is printed. 

95 IF GO is being held low after the previous step, then it 
is possible that the STOPBP cannot be disabled. In that 
case, an error message is printed. 
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96 



97 



100 



A microinstruction with STOP is forced by the CMP while 
STOPBP is disabled. If STOPON becomes true, then an er- 
ror occurred and the error message is printed. 

If, after step number 96 GO is held low (as indicated bv 
the inability of the CPU to microstep) the error message 
is printed. ^ 

The CMP forces the CPU to do a memory write to address 
1AAAAA. Then, the value read at the CMP 1MB interface is 
?!!»?a» IV J* match °- s - « the lower 16 bits are not 
.AAAAA then the error message is printed and the expect- 
ed and actual values are read. 

101 ?un e r St6P maraber 10 ° the U PP« eight bits latched by the 
CMP 1MB interface are read and compared. If they do not 
match the expected value, the error message is printed 
and the actual values read are printed. 

Same as step number 100 except a memory read from address 
! 55555 is performed. 

103 Same as step number 101 except address 1155555 is used. 

104 An MCS command, address*0, is performed. The upper bits 
of the address and opcode are checked. If not correct, 
the expected and actual values of the upper address bits 
and opcode are printed. 

110-115 For these tests, the CSAR is set to addresses !8000, 

M000, 12000, 11000, 1800, 1400, 1200, 1100, '80, '40, 

120, 110, !8, 14, 12, and 11. Then, the CSAR breakpoint 
function is tested. 

110 For this P a ct of the CSAR breakpoint test the CSAR is 
set to the breakpoint address and a breakpoint is enabled 
but, because a CPU clock has not latched this CSAR value 
into the breakpoint compare logic, a breakpoint does not 
occur. An error message is printed giving the failinq 
address. 

112 The MCLKPRE circuitry is used to clock the CSAR value on 
the CSAR lines from the CPU into the breakpoint compare 
circuitry. If the ROMBP indicator in XR7 does not indi- 
cate that a breakpoint occurred, an error message is 
printed giving the CSAR address that failed. 



102 



113 



The state of the GO is tested by attempting to microstep 
the CPU. Since a breakpoint occurred, the GO line should 
oe low, preventing microsteping. If a microstep occurs, 
an error message is printed giving the failing address. 
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114 A NOP microinstruction is forced on the CPU to cause the 
CSAR to change. Also a BPCLR is issued via XR6. it 
reading ROMBP from XR7 still indicates a breakpoint is 
occurring, an error message is printed showing the last 
CSAR breakpoint address. 

115 The GO line to the CPU is checked. Since a breakpoint 
has been cleared, the GO line should allow the CPU to 
microstep. If a microstep does not occur, an error mes- 
sage is printed. 

120 This step checks for the lower byte of the CSAR break- 
point logic being a do not care. The CSAR is set to !i 
while a breakpoint is set at adress 0. If a breakpoint 
occurs as idicated by ROMBP in XR7, an error message is 
printed. 

121 This step checks for the upper byte of the CSAR break- 
point logic being a do not care. The CSAR is set to U0O 
while a breakpoint is set at adress 0. If a breakpoint 
occurs as indicated by ROMBP in XR7, an error message is 
printed. 

130 This step checks for errors in the breakpoint logic to be 
able to compare to the upper five 1MB address bits. The 
extended address bits are set to II, !2, 14, !8, and [10 
by performing memory reads from those adresses. The imb 
breakpoint logic is enabled. If a breakpoint does not 
occur as indicated by ABP in XR7, an error message is 
printed showing the value of the extended adress bits 
used for the test. 

While performing step number 130 for the five 1MB extend- 
ed address patterns, the GO line to the CPU is checked to 
verify that it was forced low. If the CPU can still exe- 
cute a microinstruction, the GO line was not held low and 
an error message is printed. 

140 The opcode bits of the breakpoint logic are checked by 
setting a breakpoint on WRITE, then performing a WRITE 
operation. If ABP of XR7 does not indicate that a break- 
point occurred, an error message is printed. 

141 The opcode bits of the breakpoint logic are checked by 
setting a breakpoint on an MCS operation, then performing 
the MCS 0. If the ABP bit of XR7 does not indicate that 
a breakpoint occurred, an error message is printed. 

150 The 1MB breakpoint logic is checked to verify that the 
lower byte of the address is not a do not care. A Dreak- 
point is set on a memory read from address 0. Then a 
memory read from address 1 is performed. If ABP in XR7 
indicates that a breakpoint occurred, an error message is 
printed. 
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151 The 1MB breakpoint logic is checked to verify that the 
next eight bits of the address is not a do not care. A 
breakpoint is set on a memory read from address 0. Then 
a memory read from address 1100 is performed. If ABP in 
XR7 indicates that a breakpoint occured, an error message 
is printed. 

152 The extended address bits of the 1MB breakpoint logic is 
checked for a do not care. With a breakpoint set at add- 
ress 0, a memory read from address 11000 is performed. 
If ABP in XR7 indicates that a breakpoint occurred, then 
an error message is printed. 
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3.4 CPU SELFTEST 



The benefit of the CPU PROM resident test is that it operates at 
speed. The CMP does not test the CPU at speed. 

Much of the CPU is tested during the CMP-CPU interface test, in- 
cluding the 1MB interface and basic functionality of the CPU. 
Additional tests are performed during the CPU SELFTEST. If no 
errors occur during CMP-CPU interface testing, then most of the 
ALU and CTL hardware is functional. This test section performs 
more detailed tests than the previous sections. First the CMP 
performs checksums on all CPU PROMS and then invokes a CPU self- 
test subroutine that exists in CPU microcode. (See figure 3-4. ) 
Additional CPU testing is performed in the Control Panel, ADCC, 
and GIC tests. 

The CPU PROM test checks out the PROM array on the CTL board and 
completely checks the PCS board. Hard failures in the PROMS or 
buffering circuitry will be detected. Slow PROMS will probably 
not be detected, since the test occurs much slower than normal 
CPU operating speed. 

The CPU PROM resident selftest is also invoked during a COLDLOAD 
or WARMSTART. Failures are reported by the CMP and are of the 
format "HARDWARE FAILURE nnn" where nnn is the decimal failure 
parameter. If the CMP is not present the only indication that 
a failure has been detected will be that the startup will not 
occur. Refer to APPENDIX C for a procedure to force a startup. 



Error messages indicate the address of the 
are of the form: 

ERROR(row) (address) 



failing PROM. 



They 



The row number can range from 1 to 6. The address is the four 
digit hex PROM start address. If the address specified in the 
PROM is incorrect, the message "BAD ADDRESS" will be printed. 

The following table maps the error numbers to the physical PROM 
locations: 



ROW 





ADDRESS 


PCS 


10000 


PCS 


!0400 


PCS 


10800 


PCS 


10COO 


PCS 


11000 


PCS 


11400 


PCS 


11800 


PCS 


11C0O 


CTL 


1E000 


CTL 


1E400 


CTL 


1E800 


CTL 


1EC00 



U12 


U32 


U52 


U72 


U92 


U112 


U13 


U33 


U53 


U7 3 


U93 


U113 


U14 


U34 


U54 


U7 4 


U94 


U114 


U15 


U35 


U55 


U75 


U9S 


U115 


U242 


U222 


U202 


U182 


U162 


U142 


U243 


U223 


U203 


U183 


U163 


U143 


U244 


U224 


U204 


U184 


U164 


U144 


U245 


U225 


U205 


U185 


U165 


U145 


U15 


U35 


U7 5 


U95 


U105 


U125 


U14 


U34 


U74 


U94 


U104 


U124 


U12 


U32 


U/2 


U92 


U102 


U122 


U52 


U62 


U54 


U6 4 


U55 


U6 5 
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If the selftest subroutine in CPU microcode returns an error, 
then the mesage ERRORXXX will be printed, with XXX being the dec- 
imal error code returned by the test. 

The CPU microcode subroutine is invoked as follows: 

The CPU is set to HALT. 

(1) The CMP issues a system reset. 

(2) The CPU CSAR is set to the selftest subroutine address. 

(3) A STOPBP is enabled. 

(4) The CPU is set to raicrorun. 

(5) If STOPBP occurs, the CMP reads SPO. If SPO does not 
contain 0, the CMP will print the lower byte of SPO as 
an error code. 

(6) If STOPBP does not occur within ten seconds, error code 
255 is reported. 

Errors are indicated in two ways. A decimal parameter is provid- 
ed for the CMP to display in the event of an error if the CMP had 
initiated the test. The same parameter, but in HEX (i), is indi- 
cated in the CPU LEDs to make the results available if the CMP 
was not involved (front panel start-up or self-test switch). 

When the CPU Selftest is generated from the CMP but does not com- 
plete within 10 seconds the CMP generates the decimal error code 
255. The CPU is presumed to be hung and the CMP does not attempt 
to read the CPU failure parameter. 

The recommended action is to run the CPU Selftest from the Self- 
test Switch on the ALU PCA and note the failure code in the LEDs. 
See Appendix B for a more detailed procedure. 

The tests and their failure parameters in HEX ( ! ) and DECIMAL are 
listed below. After each test description, the suspect PCAs are 
listed. A hardware failure may corrupt a parameter to an undocu- 
mented or incorrect one. 

Unconditional branches (CTL, ALU) 

Conditional branches (ALU, CTL) 

Set R14Z to zero and test (ALU, CTL) 

F-bus and zero testing (ALU, CTL) 

Branch sequencing (CTL, ALU) 

NXOR, UBUS testing (ALU, CTL) 

IOR (ALU, CTL) 

SPO (ALU, CTL) 

Preliminary register test: R6 or R13 failed, but not 

both (ALU, CTL) 

Preliminary register test: R6 and R13 failed (CTL, 

ALU) 

!2A (42) IOR LSL (ALU, CTL) 

!2B (43) ZL, ZR (ALU, CTL) 

!2C (44) SR Controls and tests (ALU, CTL) 

!2D (45) CTR register and specials (ALU, CTL) 
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■20 


(32) 


!21 


(33) 


< 22 


(34) 


!23 


(35) 


!24 


(36) 


!25 


(37) 


•26 


(38) 


!27 


(39) 


!2B 


(40) 


!29 


(41) 
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POS ,NEG, BIT8 (CTL, ALU) 
Flags-control and tests (CTL, ALU) 

ALU tests (ALU, CTL) 

Carry (ALU, CTL) 

Link (CTL, ALU) 

Exhaustive tests of the 6 fundamental ALU operations 

(ALU, CTL) 

Remaining shift-less ALU operations (CTL, ALU) 

Preliminary 16 bit shifts (ALU, CTL) 

Preliminary 32 bit shifts (ALU, CTL) 

Remaining 16 bit shifts (CTL, ALU) 

Remaining 32 bit shifts (CTL, ALU) 

Register direct accessing (ALU, CTL) 

Register indirect accessing (CTL, ALU) 

Register bit testing (ALU, CTL) 

Jmp user mode (CTL) 

Repeat (CTL, ALU) 

XEQ (CTL, ALU) 

Decrement SR (CTL, ALU) 

Overflow (ALU, CTL) 

NBCC (ALU, CTL) 

CCB (ALU, CTL) 

MPY (CTL, ALU) 

DIV (CTL, ALU) 

DNEG (CTL, ALU) 

NDEC (CTL, ALU) 

CCA (ALU, CTL) 

CCOC, CLO, COCL (ALU, CTL) 

PSHA, POPA (CTL, ALU) 

Namer (CTL, ALU) 

SIR - reset SIR, SIR(6), SIR(IO) (ALU, CTL) 
SIR Timer (ALU, CTL) 
The timer is tested for 20% tolerance. More accurate 
checking cannot be done since the CPU clock speed may 
be varied as a test. An inaccurate timer will cause 
time-of-day under MPE to drift. 
!52 (82) SIR (12:14) (ALU, CTL) 
includes ICS, SS, DISP 

!70 (112) Force 1MB timeout and test (ALU, CTL) 
!71 (113) initialize MCL (MCL, ALU, CTL) 

R10(7)=i if parity error 

R10(8)=l if 1MB timeout 
!72 (114) Initialize first 256Kb to zero (MCL, ALU) 

Failing address in ABNK, R4 

R10(7)=l if parity error 

R10(8)=1 if timeout 
!73 (115) Read back first 256Kb, check for zero (MCL, SMA) 

Failing address in BBNK, R4 

OPND has failing data. 

R1Q(7>-1 if parity error 

R10(8)-l if timeout 
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I2E 


(46) 


!2F 


(47) 


!30 


(48) 


!31 


(49) 


!32 


(50) 


!33 


(51) 


!34 


(52) 


!35 


(53) 


!36 


(54) 


!37 


(55) 


•38 


(56) 


!39 


(57) 


!3A 


(58) 


!3B 


(59) 


!3C 


(60) 


!3D 


(61) 


!3E 


(62) 


!3F 


(63) 


!40 


(64) 


141 


(65) 


!42 


(66) 


!43 


(67) 


144 


(68) 


!45 


(69) 


!46 


(70) 


!48 


(72) 


< 49 


(73) 


!4A 


(74) 


!4B 


(75) 


!50 


(80) 


■51 


(81) 
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!74 (116) Write address in first 128Kb, not (address) in second 

128Kb. (HCL, SUA) 

Failing address in DBNK, R4 . 

OPND should»R4 if DBNK»0, OPND should»not (R4) if 

DBNK=1 

Rl0(7)«l if parity error 

R10(8)»l if timeout 
!75 (117) Write not (address) in first 128Kb, address in second 

128Kb. (SMA, MCL) 

Failing address in SBNK, R4 

OPND should -not (R4) if SBNK-0, OPND should=R4 if 

SBNK«1. 

R10(7)»l if parity error 

R10(8)-l if timeout 
!76 (118) Read, Write l's memory operation (RWA) . (HCL) 
!77 (119) 1MB commands RONP, DPOP, WRB, ROA (CTL) 
!7A (122) NEXT sequencing (CTL, ALU) 
!7B (123) The test attempted to return to the main microcode 

after completion or when an error was detected, but 

the attempt (CSAR) failed. The previous error code, 

if any is lost. (CTL, ALU) 
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3.5 SYSTEM CONTROL PANEL SELFTEST 

This section tests the System Control Panel, its cabling, its CPU 
interface, and its CMP interface. (See figure 3-5.) It does not 
check the validity of the channel/device switches. These should 
checked by using IOMAP. All tests occur with the CPU microhalted. 
Error messages will indicate a step number. The step numbers and 
their descriptions are as follows: 

STEP t DESCRIPTION 

10 A system reset is generated. The CPU RUN/HALT flip flop 
is set to RUN and then HALT by forcing CPU microinstruct- 
ions to set and clear the SIR's RUN bit. TGLRUN is check- 
ed by reading the CPU SIR. If the TGLRUN signal is true, 
an error message is printed. 

20 This step checks to make sure the CPU is really halted by 
checking the RUN- line from the CPU, as read by XR7. If 
the CPU is in run, an error message is printed. 

30 The CMP issues the RUN command to the Control Panel. The 
SIR register in the CPU is then checked to ensure TGLRUN 
is true. If it is not, an error message is printed. 

40 The CPU SIR register is set to RUN. Then, the RUN- line 
from the CPU is checked to verify that RUN went true. If 
it did not, then an error message is printed. 

50 The CPU SIR register is checked to ensure the TGLRUN sig- 
nal from the Control Panel went false. If it is still 
true, an error message is printed. 

52 A RUN command is sent to the control panel. Since the CPU 
is in run, the panel should not generate a TGLRUN signal. 
If the CPU SIR register indicates that TGLRUN is true, an 
error message is printed. 

60 A HALT command is sent to the control panel. Then, the 
CPU SIR register is checked to ensure the CPU received the 
TGLRUN signal. If TGLRUN is not true, an error message is 
printed. 

6 2 The CPU SIR is set to HALT and a HALT command is issued to 
the control panel. Then, the CPU SIR register is checked 
to verify that TGLRUN is not true. If TGLRUN is true, an 
error message is printed. 

80 The CPU SIR is set to RUN. Then, control panel status is 
checked. If RESET is indicated true by the panel status, 
an error message is printed. 

90 A RESET command is sent from CMP to the control panel . 
Then the control panel status is read by the CMP. If RE- 
SET is not being indicated, an error message is printed. 

3-18 



CMP/System Selftest 

100 The CMP waits up to 200ms for the RESET signal to cease 
being asserted by the control panel, as indicated by the 
status read from the panel by the CMP. If the status 
continues to show RESET is being asserted after 200ms, an 
error message is printed. 

110 The CPU SIR is set to HALT. Then, a LOAD command is sent 
from the CMP to the control panel and the control panel 
status is read by the CMP. If LOAD and RESET are not be- 
ing indicated, an error message is printed. The expected 
and actual values of status are also printed. See Step 
190 for status breakdown. 

130 Several clocks to the CPU are allowed to ensure that the 
system RESET, generated by the LOAD operation, actually 
is resetting the CPU. The CPU CSAR is checked to ensure 
that it is at zero. If it is not at zero an error mess- 
age is printed. 

140 The CMP waits for the control panel to cease asserting 
RESET signal. Then, the CPU SUCH register is checked to 
verify that EDO and EDI are being asserted properly. If 
the RESET never finishes or ED0/ED1 are incorrect, an 
error message is printed. The values printed indicate 
the expected and actual EDO and EDI bits in the SWCH reg- 
ister. 

150 The CPU SWCH register is monitored to verify that ED0/ED1. 
eventually return to zero. If they do not return to zero 
within 400ms, an error message is printed. 

160 A START command is sent to the control panel by the CMP. 
Then, the control panel status is read. If the status 
does not indicate START and RESET being asserted, an 
error message is generated with the expected and actual 
values of the status printed. 

170 The CMP waits for RESET to cease being asserted, then 
checks ED0/ED1 in the CPU SWCH register. If these bits 
are not correct, an error message is printed along with 
the expected and actual values of ED0/ED1. 

180 A DUMP command is sent to the control panel by the CMP. 
Then the control panel status is read. If the status 
does not indicate DUMP and RESET being asserted, an error 
message is generated with the expected and actual values 
of status included. See Step 190 for status breakdown. 
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190 The CMP waits for RESET to cease being asserted, then 
checks ED0/ED1 in the CPU SWCH register. If these bits 
are not correct, an error message is generated with the 
expected and actual values of ED0/ED1 included. The sta- 
tus from the control panel is printed. The individual 
bits have the following meanings when set: 

BIT MEANING 

START is being asserted by the panel. 

1 DUMP is being asserted by the panel. 

2 LOAD is being asserted by the panel. 

3 SYSTEM RESET is being asserted by the panel. 

4 OVERTEMP is being detected by the panel. 

5 MAINT MODE switch is set to ON. 

6 CONTROL FUNCTIONS switch is set to ON. 

7 REMOTE switch is set to ON. 

The value of the SYS DISC switch is printed. The value 
is read from the CPU SWCH register. 

3.6 ADCC SELFTEST 

The ADCC selftest is divided into two parts; ADCC TRANSMIT and 
ADCC RECEIVE. The ADCC TRANSMIT test checks the ability of the 
ADCC to use transmit channel 1, ADCC port to send a character 
to the CMP. The CMP communicates with the ADCC over the 1MB to 
set up the ADCC properly and transmit the character. The charac- 
ter is received by the CMP UART which interfaces to the ADCC. If 
the character is not received, the message "TEST FAILED" is 
printed. If no ADCC is found at channel 1, the message "NO ADCC" 
will be printed. Refer to Appendix A for descriptions of other 
error messages that may be printed. 

The ADCC RECEIVE TEST checks the ability of the ADCC channel 1, 
port to receive a character from the CMP. The CMP sets jp the 
ADCC for receive using 1MB commands forced tnrough the CPU. 
Then, the CMP sends a character to the ADCC and forces 1MB comm- 
ands via the CPU to read the character. If the character is not 
received properly, the message "TEST FAILED" is printed. Other 
error messages are described in appendix A. See figure 3-6 for 
areas affected by this test. 
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3.7 GIC SELFTEST 

The GIC selftest is performed on every GIC found in the system. 
(See figure 3-7.) The messages generated are as follows: 

CSRQ This indicates an error in the CSRQ logic on the GIC 
or in the CPU. 

IRQ This indicates an error in the IRQ logic on the GIC or 
in the CPU. 

REQ This indicates an error in the register pattern test 
on the GIC. 

DNV This indicates an error in the DNV logic of the GIC or 

CPU. 

DMA This indicates failure of a DMA transfer from the PHI 
buffer to memory. 

If the GIC test fails for all GIC's, the failure is probably in 
the CPU. The GIC diagnostic should be used for more specific 
information and troubleshooting. 
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3.8 DATA COMM SELFTEST 



This test requires that the Data Coram Test Adapter part number 
(30090-60052) is installed between the CMP connector J3 and the 
CMP-ADCC cable. See figure 3-10 for adapter wiring configuration. 

Enter the DCTEST command to invoke this test. It will test the 
RS-232C interface to the system/remote consoles. 

This test is divided into two basic sections. Steps 1-16 check 
RTS, DTR, REMON, and SPAREXMT outputs and the DSR, CTS, CD, and 
SPAREREC inputs. Figure 3-8 illustrates how the control signals 
are looped from output to input. Steps 20-28 check the RS-232C 
serial data paths. (See figures 3-9 thru 3-17.) 

Error messages are of the form "ERROR IN STEP <step#> <expected 
data> <actual data>. The lower bits of the expected and actual 
data have the following meanings. 

For steps 1-16: 

BIT MEANING 

12 Data Set Ready (DSR) 

13 Clear To Send (CTS) 

14 Carrier Detect (CD) 

15 Spare Receive (SPAREREC) 

The following control information is set up for steps 1-16. 

CONTROL EXPECTED STATUS 

STEP# RTS DTR REMON SPAREXMT DSR CTS CD SPAREREC 
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For steps 20-28 the upper byte of the expected and actual data is 
the character received on the CMP ADCC uart (AURT). The lower 
byte is the character received on the CMP console uart (CURT) . 
The steps perform the following operations. 

AURT CUI 

STEPt TXON ACKMODE ADCCODIS REMON XMIT XMIT 

20 1 10 

21 1 1 1 

22 1 10 

23 1 1 11 

24 1 1 11 

25 1 10 

26 1 1 11 

27 1 1 11 

28 10 

Continents on steps 20-28: 

20 See figure 3-9. 

21 See figure 3-10. 

22 ACK logic is cleared in preparation for tests 23 and 24. 
(See figure 3-11. ) 

23 This step leaves the ACK circuitry in a state that should 
allow Remote Console data to be received by the CURT in the 
next step. (See figure 3-12.) 

24 The ability of the CURT to receive Remote Console data is 
tested after the ACK circuitry has been set up by step 23. 
(See figure 3-13. ) 

25 The ACK circuitry is cleared in preparation for steps 26 
and 27. (See figure 3-14.) 

26 Data from the Remote Console sets the ACK circuitry to 
allow data from the Remote Console to be received by CURT 
in the next step. (See figure 3-15.) 

27 The ACK circuitry was pre-conditioned by step 26 to allow 
data from the console to be received by the AURT in this 
step. (See figure 3-16.) 

28 See figure 3-17. 

The Data Comm Test Adapter also routes the RATE SELECT switch 
(#3 of switch U134) to the "D" LED on the edge of the CMP. When 
the switch is closed, the LED should be ON. 
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Figure 3-8. Data Conun Test Adapter Configuration (continued) 
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Figure 3-9. Data Conun Test Step 20 
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Figure 3-10. Data Coram Test Step 21 
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Figure 3-11. Data Coram Test Step 22 
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Figure 3-12. Data Comra Test Step 23 
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Figure 3-13. Data Comm Test Step 24 
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Figure 3-14. Data Comm Test Step 25 
3-34 



CMP/System Selftest 



TXON 

,|jum 



AURT TXD 

U97 RXO 



^~x> 



J3J0 

> 



CURT TXO 

U117 RXO 



ADCC J_ 
DISABLE 



1/ lADCCO , 



SET TO INHIBIT 
REMOTE CONSOLE 



CONSOLE ACK LOGIC 



SET TO INHIBIT 
LOCAL CONSOLE 




"T - ^ 



J3-t9| 



-^D^ 



REMOTE ' 
U141 CONSOLE 



11 7H 13 



K2 



^CP 



i U1S1 AOCC1 

2X> 



TEST 
ADAPTER 



Figure 3-15. Data Comm Test Step 26 
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Figure 3-16. Data Comm Test Step 27 
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Figure 3-17. Data Comm Test Step 28 
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The following error messages may be generated during system self- 
tests. Generally, serious error messages are shown in inverse 
video by the CMP. 



BAD ADDRESS 



This means that the address indica- 
ted by the CPU microcode word near 
the end of the Ik block of PROM 
does not match the physical address 
of the PROM. If a checksum error 
does not occur, it means the PROMS 
have been loaded wrong or the ad- 
dressing of the board holding the 
PROMS is incorrect. 



BAD CHECKSUM 



This means that the checksum in CPU 
microcode PROM is incorrect. This 
generaly indicates that a PROM has 
failed. The numbers displayed will 
indicate the PROM which has failed. 



CAN'T MHALT 



CPU cannot be microhalted. Probab- 
ly due to CPU clock failure or CMP 
microstep logic failure. 



CAN'T MS 



CAN'T READ 



CPU is frozen. The freeze may be 
an internal CPU freeze or a CMP 
failure in its breakpoint or micro- 
step logic. 

The CMP cannot read the channel or 
device switches on the system con- 
trol panel. Probable due to hard- 
ware failure on SCP, CPU, or CMP. 



CAN'T PS 



CAN'T SET 



The CPU cannot be program stepped 
because it is microhalted or pro- 
gram running. 

The register specified cannot be 
set. Unsettable registers include 
CIR, R14, and SWCH. 



CMP FAILURE 



A failure has been detected that is 
probably on the CMP. Additional 
information will be printed to fur- 
ther describe the source of the 
failure. 
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CPU BAD 

CPU FROZEN 

CSRQ 

DISABLED 

DMA 

DNV 

GO TO HW 

INVALID - USE HELP 



INVALID EXPRESSION 



IRQ 



NO ADCC 



NO 1MB DEV 



During the CPU PROM test, the CPU 
did not execute NOP microinstruc- 
tions properly. This could indi- 
cate a failure on the CMP or CPU. 

The CPU cannot execute NOP micro- 
instructions. This could be caused 
by a failure on the CMP or CPU. 
While performing the GIC test, the 
GIC did not assert CSRQ properly. 

The function requested has been 
disabled on the system control pan-' 
el. Change the enable switches on 
the control panel an re-enter the 
command. 

While performing the GIC test, the 
GIC did not perform a good DMA 
transfer into memory. 

While performing the GIC test, the 
GIC did not assert DNV correctly. 

Enter the "HW" command before at- 
tempting the operation again. 

The command entered was not a valid 
CMP command in the current mode. 
HELP will display a list of valid 
commands. Maintenance Display com- 
mands are not valid unless the DIS- 
PLAY command has been entered. 

The command used required a valid 
numeric expression. The expression 
used did not exist or could not be 
decoded. Remember to use hex num- 
bers only when in hex mode and oct- 
al numbers only when in octal mode. 

While executing the GIC test, an 
error was found in the GIC's asser- 
tion of IRQ. 

Channel 1 is not an ADCC. Conse- 
quently the ADCC loopback. test can- 
not be performed. 

A timeout occurred on the 1MB while 
reading/writing to memory or I/O. 
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NOT CONTROLLER 



While performing the GIC test, the 

GIC was found to be configured not 

to be a controller. Therefore, the 
test was aborted. 



NOT VERIFIED 



The baud rate was not changed be- 
cause the letters "MPE" were not 
read at the new baud rate. 



OVERTEMP SHUTDOWN 



The system control panel indicates 
the system is overheating. There- 
fore, the CMP will assert PFW to 
cause main power supplies to turn 
off. 



REG 



During the GIC test, the pattern 
test of registers found a failure 
on the GIC. 



SELFTEST FAILED 



SYSTEM HALT 



Somewhere during execution of self- 
test, a failure was found. Exam- 
ination of prior messages should 
give a more specific message. 
The CPU is halted. The parameter 
printed, if present, gives the sys- 
tem halt or CPU selftest parameter. 



TEST FAILED 



The selfttest step under 
failed. 



execution 



TIMER FAILED 



The CMP timer is not functional. 
The CMP will probably be unable to 
function properly. 



TOO MUCH DATA 



When specifying data to be stored 
in memory, too many data words were 

specified. 



TURN UPDATE OFF 



Updates must be turned off with the 
UPDATE command before performing 
this function. Specifically, micro- 
step cannot give meaningful results 
with updates enabled. 
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The CPU portion of the CMP/System Selftest may be initiated from 
the CPU Selftest switch on the ALU PCA. The test results are re- 
ported by the eight LEDs on the ALU PCA. This test checks the 
ALU PCA, CTL PCA without checksum on PROMs, and 256 Kb of memory. 

The test domain is similar to figure 3-4, except that the CMP is 
not involved. The CPU Selftest switch is provided for the con- 
venience of the CE when troubleshooting CPU/memory problems, when 
the CMP is absent, or when the CPU portion of the CMP/System 
Selftest hangs. 

The CPU must be halted to run the test. The test is initiated by 
pushing in the CPU Selftest switch on the ALU PCA. Successful 
test execution is indicated by only the bottom LED being lit 
after approximately two seconds of LED activity. 

If LED activity stops with any other indication, a failure has 

been detected. The LED failure indications are formatted such 

that the upper three LEDs hold one digit, the next four LEDs hold 

the second digit, and the bottom LED provides parity over all 
eight LEDs. 



EXAMPLE: 



64 
32 
16 
8 
4 
2 
1 



— 011=3 
10ii=B 



s- 



WHERE: ! 3B = 32+16+8+2+1 = 59, indicating from the table 

on page 3-15 that a regis- 
ter bit failure occurred. 

The problem is probably the ALU PCA. 

Always check the parameter in the LEDs for correct (odd) parity 
because a hardware failure could corrupt the parameter to incor- 
rect parity and/or an undocumented number. 



The LEDs are driven by the most significant byte of SPO. 
parameter reported is the least significant byte of SPO. 



The CMP 
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This appendix provides the CE with two methods of forcing a LOAD/ 
START operation when the CPU portion of the CMP/System Selftest 
fails. 

CAUTION 

These procedures should only be used in critical 
situations. Using them with defective hardware 
could cause irrecoverable data loss or unreliable 
results. 

Method 1 - Type DUMP 

Go interactive (CNTRL Y) 
Type WARMSTART 

Method 2 - Set MAINTENANCE MODE switch on front panel to ENABLE. 
Halt the system 



Type DISPLAY 








Type RESET 








Type CSAR=BE8 






Type X=<parm 


> 






Where: 


parm 


(0-6) = 







parm 


(7) = 


if normal, 1 if split disc 




parm 


(8) = 


if LOAD, 1 if START 




parm 


(9) = 1 






parm 


(10-12) 


■ channel number minus 4 




parm 


(13-15) 


= device number 


Type MRUN 


(system should go to RUN) 


Enter a CNTRL B character 




Type EXIT 








Should get LOAD/START prompt, proceed normally. 
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10 INTRODUCTION 

The Diagnostic/Utility System (hereafter referred to as DUS) is a 
memory-resident means of running diagnostic and utility programs. 
The Stand Alone File Manager (hereafter referred to as FMGR) is a 
disc or tape based software module forming the heart of the DUS. 
In addition to the FMGR, the DUS includes AID together with a set 
of SPL, SPL-II, and AID programs and supporting files. Generally 
those programs provided in support of the Operating System are 
classified as Utilities and programs whose primary function is to 
test hardware and firmware subsystems or peripherals are class- 
ified as Diagnostics. Independent of operating systems, the FMGR 
gives you access to files (located on a disc or tape) and enables 
you to modify, delete, add, or create those files. Also, a disc 
or tape-based directory allows interchange of file information 
with other discs/tapes. The DUS. is compatible with any HP 3000 
HP-IB version computer system. 

It is assumed that the operator is familiar with the nomenclature 
used in describing keyboard terminals and the Control Panel. 

It is implied that all user inputs are terminated with ENTER, 
carriage return/linefeed, or similiar function on the console 
device . 



1.1 HARDWARE REQUIREMENTS 

The following hardware is required : 

A Hewlett/Packard HP-IB version computer system consisting of: 

(1) Memory - Minimum system memory configuration 

(2) Console- HP 3000 System Console or HP terminal 

(3) System cold load device 

(14) Printer- HP 2613, 2617, 2619, 2631, or 2608 (optional) 
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Figure 1.1 provides a pictoral view of how the FMGR integrates 
with other program modules. 



DISC/TAPE DEVICE 

Diagnostic 
-Utility 
Disc/Tape 



MEMORY 

I Enter Your Program Name 
I : 

valid responses are: 



I Directory I 
I and I 
I Files I 



I AID type file |->Load and 

' ■ execute AID 

program file-' 



KEYBOARD 

CONSOLE 



I Operator l<-->l 
I Interaction | 



ISPL-II type file|->Load and 

' ■ execute 

SPL or SPL-II 
program 

file ' 



PRINTER 



Hardcopy 
Output 



|< — >| 

I 



IMANAGER I >Execute DUS— ' 

i AID j >Execute AID— 



♦ Optional 

Figure 1.1 - Diagnostic/Utility System Structure 
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2.0 INTRODUCTION 

This section covers the specific operating instructions required 
to load the Diagnostic Utility System (DUS) and to manipulate the 
file manager portion of the DUS. 

2.1 LOADING THE SYSTEM 

(1) Perform an MFE 'SHUTDOWN' to properly logoff every current 
session, if applicable. 

(2) Run the console Self -Test by pressing TEST on the keyboard 
and verify the displayed results (see Terminal's User's 
Manual) . 

(3) Fully reset the console by depressing the RESET TERMINAL key 
rapidly twice. 

(4) Ensure that the console is in REMOTE. (REMOTE key in de- 
pressed position.) 

(5) Install a DUS Disc/Tape on the Cold-Load Device (flexible 
disc or tape unit). 

(6) Set front panel COLD LOAD thumbwheels to CHAN ADDR and 

DEVICE ADDR of Cold-Load Device. 

(7) Press HALT, then press COLD LOAD. 

(8) The welcome message and prompt are displayed: 

Diagnostic/Utility System (revision XX. XX) 

Enter your program name (Type HELP for program information) 

(The revision is determined by the latest release date of the 
FMGR program. ) 

(HELP is an AID program that presents file and command 
information. ) 
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12 RUNNING DUS PROGRAMS 

To execute an AID or SPL-II program file, enter the program 
name as follows : 

Enter your program name (Type HELP for program Information) 
:PROGNAME (The program PROGNAME will now be loaded and executed) 

I 

I 
(Upon completion of the program the Diagnostic/Utility System 
returns to its entry mode) 

Enter your program name (type HELP for program information) 



2.J USING THE FILE MANAGER 

If you wish to create, modify, or inquire about files type 
"MANAGER". You will be prompted with: 



Stand Alone File Manager 

Enter Command (LC for List Command) 

> (Any DUS command may now be executed) 



2.4 USING AID 

If you wish to create, modify, or make changes to an AID program, 
you may do so by typing "AID". The resulting interaction is des- 
cribed in the AID Diagnostic Lanaguage Manual, located in this 
binder. 
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3.0 INTRODUCTION 

The information in this section pertains to the file management 
structure and how diagnostic and utility programs are classified. 

3.1 FILENAMES 

Filenames are restricted to eight alphanumeric ASCII characters 
starting with an alpha character. 

Valid Filenames Invalid Filenames 



TEST UDIAG 

D44TEST TEST . 

ADCCDIAG ■ TEST 

B AB/TEST 

Note -The filenames AID, DIREC, IDSB00T and SCRATCH are reserved. 
32 FILE TYPES 

Internally, files are typed as follows: 

Type Description Created by 

AID AID program AID SAVE Command 

SPLII SPL or SPL-II program TPSTOMP Program 
DATA data file CREATE Command 

The AID and SPL-II types constitute the programs available to the 
user. The DATA files are transparent to the user but are used by 
development or accessed by some of the programs. 

J.3 FILE CLASSES 

File classes have no significance to the Diagnostic/Utility 
System. They are provided for the support of software which reads 
the directory. AID and SPL-II program files are classified 
according to the service they provide. There are two classes of 
program files: UTILITY (U) and DIAGNOSTIC (D). 

Data files are classified by content: ASCII (A), BINARY (B). 
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At file creation time each AID program file is classified as a 
DIAGNOSTIC, each SPL-II program file as a UTILITY and all DATA 
files as ASCII. The CLASSIFY Command may be employed to change 
the classification as required. 

3.4 FILE ACCESS 

The Stand Alone File Manager user may access any file on any 
DUS Disc/Tape. In other words, if you have entered an AID program 
and cannot save it because of lack of space, you may remove the 
currently installed DUS Disc/Tape, install another, and again 
attempt to save your program (this process is repeatable indef- 
initely). Similarly, if you need a file that does not reside on 
the currently installed DUS Disc/Tape you can remove it, install 
another, and determine whether or not the new disc/tape contains 
the file- you want . 

There are some restrictions when accessing certain types of 
files. Most of these restrictions will be pointed out throughout 
this document, however a few general rules apply: 

- The files DIREC and SCRATCH* are permanent files; they 
cannot be modified in any way. 



- The files DIREC, and 
SCRATCH can be written. 



SCRATCH can all be read; but only 



Files that are protected must be unprotected before alteration 
(See CHANGE Command). 



•The SCRATCH file is a 7.680 word 
as an unprotected scratch file. 



scratch area usable by anyone 
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4.0 INTRODUCTION 

The Stand Alone File Manager contains a command set that allows 
alteration of and access to files. The commands are explained in 
detail on the following pages. For convenience, some parameters 
are optional; optional parameters are enclosed in brackets!]. The 
operator may input any valid command after the DUS prompts with: 

Enter Command (LC for List Commands) 

Any error in syntax or errors which occur during command 
execution are identified by a message which should be easily 
understood by the operator. However, should difficulty arise 
understanding an error message refer to the Error Messages 
Section. 



4.1 CHANGE 

OPERATION NAME: Change file security 



MNEMONIC : 



CHANGE filename TO UNPROTECTED] 
CHANGE filename TO PROTECTED] 



DESCRIPTION: Allows the operator to protect or unprotect a file. 
A protected file indicates it is not PURGEable and 
is read-only. 

EXAMPLES(S): Enter Command ( LC for List Commands) 

>CHANGE DIAGU TO P (changes the file DIAG4 to a 

non-PURGEable and read only file) 

Enter Command (LC for List Commands) 
>CHANGE DIAG4 TO U (change DIAGU to a PURGEable 
read/write file) 
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4.2 C'HANGEIO 

OPERATION NAME: Change I/O device number 

MNEMONIC: CHANGEIO CONSOLE TO channel number, device number 
[PRINTER] 

DESCRIPTION: Changes the default I/O device used by the DUS . The 
channel number is accepted as decimal in the range 
0<=channel number '=15 and the device number must be 
in the range 0<=device number <=7. There must be a 
legal device at that location. A channel and device 
number equal to implies that a device is not 
available to the DUS. See LISTIO command. 

EXAMPLE(S): Enter Command ( LC for List Commands) 
> LISTIO 

DEVICE TYPE CHANNEL DEVICE 



CONSOLE 3 

DISC or TAPE 2 6 

PRINTER 2 3 

Enter Command ( LC for List Commands) 
>CHANGEI0 PRINTER TO 3 , 1 (change printer to 

CHANNEL 3. DEVICE I 
Enter Command ( LC for List Commands) 
> LISTIO 
DEVICE TYPE CHANNEL DEVICE 



CONSOLE 3 

DISC or TAPE 2 6 

PRINTER 3 1 

NOTE 

Disc or Tape device is always set to Cold-Load 
thumbwheel switches during execution. 

Only change thumbwheel switches when DUS or AID 
is waiting for input. 



*.i CLASSIFY 

OPERATION NAME: Reclassify a file 
MNEMONIC: CLASSIFY filename AS class 
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DESCRIPTION: This Command has no significance to the Diagnostic/ 
Utility System but provides support for software 
which accesses the directory. 

It allows the user to reclassify the file filename 
to a new class where 

class = U[TILITY] 

D[IAGNOSTIC] 

A[SCII] 

B[INARY] 

Enter Command (LC for List Commands) 
CLASSIFY DATA1 AS B (changes the file DATA1 

to a BINARY classification) 



EXAMPLE(S) 



4.4 CREATE 

OPERATION NAME: Create a data file 

MNEMONIC- CREATE filename, number of sectors [, revision] 

OR 
number of words divided by 128 
[.revision] for DUS on tape 



DESCRIPTION: 



EXAMPLE* S) 



4.5 EXIT 



Creates (i.e. adds to the directory of files) an 
ASCII data file named "filename" which will be 
"number of sectors" long (disc) or "number or words 
divided by 128" (tape). The range for number of 
sectors is 1< =sectors<=310 . If the optional revision 
is not added, then the revision 00.00 is used. (See 
LF command for the format of revision) . 

Enter Command (LC for List Commands) 

>CREATE TEST,t, 01.02 (creates an ASCII data file 
TEST with a length of 1 sec- 
tors, on a disc, or 512 words 
on tape and a revision of 
01.02) 



OPERATION NAME: Leave file manager 



MNEMONIC : 
DESCRIPTION : 

EXAMPLE! S) : 



EXIT 

Causes computer to leave the file manager and return 
to the Diagnostic/Utility System entry mode. 

Enter Command (LC for List Commands) 
>EXIT 



Enter Your Program Name 
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4.6 LC 

OPERATION NAME: List the file management commands 
MNEMONIC : LC 

DESCRIPTION: Lists the File Manager Commands followed by a short 
description of what the command does. 

EXAMPLES(S): Enter Command (LC for List Commands) 
>LC 

LF List the file directory 



4.7 LF 

OPERATION NAME: List the file directory 

MNEMONIC: LF [P[RINTER]] 

DESCRIPTION: Lists the file directory of the resident DUS Disc/ 
Tape which contains all pertinent information for 
the user. If the optional PRINTER is used, the 
directory will be listed on the system printer 
device. 

EXAMPLE(S): Enter Command (LC for List Commands) 
>LF 

Stand Alone File Directory (when using flexible disc) 

File- 
name Type Class P/U Length Cyl Hd Sec Revision Prog Data Stack 



DIREC DATA 


B 


P 


640 


8 


1 


7 


00.00 








o 


IDSBOOT DATA 


M 


P 


2432 


8 


1 


12 


00.00 








o 


SCRATCH DATA 


B 


u 


7680 


9 





1 


00.00 











AID SPLII 


U 


P 


21530 


10 





1 


02.04 


16171 


5359 


6783 



CYLINDERS USED»50 

Stand Alone File Directory (when using magnetic tape) 

File- 
name Type Class P/U Length File Num Revision Prog Data Stack 



TEST 
DIAG 
ABC 


AID 

SPLII 

DATA 


U 
D 
A 


P 

U 
U 


427 
400 
1280 




1 
2 


00.00 
00.00 
00.00 


320 
300 




28123 

100 




107 
200 





4-4 



Diagnostic/Utility System 

Stand Alone File Directory (when using cartridge tape) 

File- 
name Type Class P/U Length Block Num Revision Prog Date Stack 

DIREC DATA B P 640 197 00.00 

IDSBOOT DATA M P 2432 199 00.00 

SCRATCH DATA B U 7680 203 00.00 

ADCCDIAG SPLII D P 14086 218 01.31 12715 1371 5627 

MEMDIAG SPLII D P 9522 280 00.11 7687 1835 6038 

The list header has the following meaning: 

Filename - the name of the file. 

Type - the file type that filename is currently designated as 
(See File Types paragraph 3-2 for explanation of type 
meanings . ) 

Class - classification of the file. (See File Class paragraph 
3.3 for explanation of class meanings.) 

P/U - designates whether the file is Protected or 
Unprotected. 

Length - the length of the file in words . This length is 
calculated as follows : 

AID type = size of the AID program before execution 
SPLII type =size of the program (PL-PB) * size of the 

data area (DL-DB). The stack (Z-DB) occupies 

no space in the file. 
DATA type 'created size 

Cyl - The physical disc cylinder address of the file. 

Hd - The physical disc head address of the file. 

Sec - The physical disc sector address of the file. 

File Num - Logical File Number on Tape. 

Block Num - Physical block address of the file on cartridge tape. 

Revision - A five-digit code with the following format: 

01.02 

where 01 signifies the major revision level and 
02 signifies the minor revision level. 

Prog - This length in words is calculated as follows: 

AID type =program area (object code) of the AID program 
SPLII type =Program Limit-Program Base Register (PL-PB). 
DATA type =no significance. 
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Data - this length in words is calculated as follows: 

AID type 'program area available for the AID program. 
SPLII type *Data Limit-Data Base register (DL-DB) . 
DATA type -No significance. 

Stack - this length in words is calculated as follows: 

AID type "(number of AID statements in the program x 2) 
SPLII type 'Stack Limit-Stack Base register (Z-DB). 
DATA type *No significance. 
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The "CYLINDERS USED" message, when using a flexible disc, 
indicates the amount of cylinders allocated by the system 
including the "holes" left by PURGE and SAVE. 



4.8 LISTIO 

OPERATION NAME: List the System I/O 
MNEMONIC : LISTIO 



DESCRIPTION: 



Lists the current I/O configuration of the System 
Console, Flexible Disc or Tape, and Line Printer. 
This configuration may be modified by hardware 
(changing a device's device number) or by software 
(see CHANGEIO command). A channel and device number 
equal to implies that a device is not available to 
the DUS. 



EXAMPLES(S): See CHANGEIO command example. 



4.9 LOAD 

OPERATION NAME: Load file into memory 

MNEMONMIC: LOAD filename 

DESCRIPTION: Loads a file into the memory, This command would 
typically be used for modifying a file (i.e. LOAD, 
modify memory, SAVE) or for transferring a file from 
one disc/tape to another (i.e. LOAD, switch discs, 
SAVE or LOAD, switch tapes, SAVE). 

4.10 PACK (Not available on DUS Tape) 

OPERATION NAME: Pack files 

MNEMONIC : PACK 

DESCRIPTION: The disc is never packed until this command is 
executed so "holes" may develop in the file 
structure as a result of the PURGE and SAVE 
commands. To remove these "holes" a PACK should be 
executed so that the files on the disc will be 
contiguous. Note however, an unpacked disc presents 
no problem until a file cannot be stored because of 
no room left on the disc . 
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4.11 PURGE 

OPERATION NAME: Purge File 
MNEMONIC: PURGE filename 

DESCRIPTION: Allows an operator to erase a file from a disc/tape. 
All files may be purged except protected files . If 
a protected file must be purged the operator must 
change the file to unprotected and then purge it 
(See CHANGE command). 

EXAMFLE(S): Enter Command (LC for List Commands) 
> PURGE DIAG 



402 RENAME 

OPERATION NAME: Rename Pile 

MNEMONIC: RENAME old name, new name 

DESCRIPTION: Allows the operator to change the name of a file. 
No other characteristic of the file is changed . 

EXAMPLE(S) : Enter Command (LC for List Commands) 

> RENAME DIAG1, DIAGU4 (DIAG1 becomes DIAG44 (i.e. 
DIAC1 no longer exists ) . 

4J3 SAVE 

OPERATION NAME: Save a file by storing it on a disc or tape 

MNEMONIC: SAVE filename [.revision] 

DESCRIPTION: Stores the AID, SPLII or DATA file that is currently 
in memory onto the System disc/tape. This command 
would typically be used for modifying a file 
(i.e., LOAD, modify memory, SAVE) or transferring 
a file to another disc/tape (i.e., LOAD, switch 
discs/tapes, SAVE). If the optional revision is not 
added, the current revision of the file is used. 
(See LP Command for revision format.) 



EXAMFLE(S): 



Enter Command (LC for List Commands) 
>SAVE DIAG, 01.02 
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5.0 INTRODUCTION 

This manual section discusses the possible error conditions that 
may occur during Diagnostic/Utility System operatons . 



5.1 FIRMWARE TRAPS 

If the machine firmware detects a condition that t«kes control 
from the executing user program (e.g. BOUNDS VIOLATION, STACK 
OVERFLOW) because of either a software or hardware problem, the 
following message is printed on the System Console: 

Example: '"SYSTEM FAILURE" 

While executing FILENAME 
Delta P-Wtl Code Segment = 3 
Stack Overflow 

Delta P equals the octal offset from ?B*0. Code segment equals 
the code segment that was executing when the failure occurred and 
finally, a descriptive message indicating the 
failure (i e. Stack Overflow in this example), 
halted and if RUN is pressed an attempt to recover 
Diagnostic/Utility System entry mode is made. 



nature of the 
The system is 
back to the 



52 ERROR MESSAGES 
Message 



Invalid Filename 



Disc Failure!! Did 
not respond within 
10 seconds 



Printer Failure!! Did 
not respond within 
10 seconds 



Meaning 

The filename parameter did not meet the 
requirements of a valid filename (See 
FILENAMES Section) . 

The system disc didn't complete a seek, 
read or write within a reasonable time 
(approximately 10 sec). Possible hard- 
ware failure. 

A line printer output was requested but 
the line printer did not complete its 
operation in normal time (approximately 
10 seconds). Check for printer on-line, 
printer device correct, and printer 
attached to HP-IB correctly. 
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Error on Directory 
write! Media is 
probably no longer 
usable ! 



While writing an updated directory, a 
write and subsequent retry failed. The 
directory may be in one of the following 
states : 



1) Invalid data was written, meaning the 
Diagnostic/Utility file system media 
is no longer usable. 

2) No write actually occurred, meaning 
the Diagnostic/Utility System media 
is intact with the last file opera- 
tion disregarded. 

3) Enough data was written, before the 
error occurred meaning the Diagnostic 
Utility System media would be intact 
with the last file store operation 
successful. 



File Directory Full 



Insufficient Disc Space 



File access violation 



File system 
unaltered 



No such file 



In any case, try a new cold-load and LF 
Command to ascertain the condition of 
the Diagnostic/Utility Disc or Tape. 

The current operation would exceed the 
58 filename directory entries limit . 
Alternatives include PURGEing a file or 
using another disc/tape. 

There's no disc space available for this 
file. Alternatives include inserting a 
different Diagnostic/Utility Disc and 
retrying the store operation or execut- 
ing the PACK Command and then retrying 
the store operation. 

This error occurs when a file access is 
attempted on a file or file type that is 
not compatible with the command or oper- 
ation, e.g. RENAME oldf ile ,newf ile where 
newfile exists already or an attempt is 
made to alter the files DIREC , IDSBOOT, 
or SCRATCH. 

Can occur during a command such as SAVE. 
A recoverable disc error occurred with 
no alteration of the directory. Retries 
of the last operation may be attempted. 

Indicates that the specified file 
doesn't exist in the resident Diagnostic 
Utility Filename Directory. Check for 
misspelling or try another Diagnostic/ 
Utility Disc or Tape. 
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Not a Diagnostic/ 
Utility System 



Invalid Command 
or Input 



Abort!! System not 
usable 



•• SYSTEM FAILURE*" 
No File in memory 

File Protected 

Pack Aborted ! ! 
Invalid Revision 



SEEK/READ /WRITE 
FAILURE ! ! 



Disc is Write Protected 
or not in the drive. 



Not a Printer device 



Indicates an attempt was made to store a 
file onto a disc or tape other than a 
Diagnostic/Utility Disc or Tape. 

The command requested or parameters 
following it do not conform to the 
required command structure. Execute an 
LC command or refer to the command 
description to ascertain the correct 
format. 

The last operation resulted in an irre- 
coverable error. Verify correctness of 
the last operation. Cold load to 
attempt restart . 

See Firmware Traps paragraph 5 . 1 of this 
document . 

A SAVE Command was attempted when no 
valid file is resident in memory. See 
LOAD command . 

Ah attempt was made to PURGE a file 
which has been been designated as 
protected. See CHANGE command for 
changing protected status . 

An irrecoverable disc error occurred 
during the PACK Command. 

The revision input did not meet the 
syntax requirement . See LF Command for 
the expected format . 

A disc error occurred while accessing 
the system disc. This message will be 
preceded by a message indicating the 
two word status (in hex) returned by 
the disc as follows: 

SEEK/READ/WRITE STATUS' IXXXX 1XXXX 

A disc access was attempted when a 
diskette was not in the drive. Also 
a disc write attempt to a write pro- 
tected disc will produce this message. 

A CHANGEIO command attempted to desig- 
nate a device which does not identify as 
a supportable printer. 
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Can Not Write Past 
End Of Tape 

Magnetic Tape 
Transfer Count 
Is X, Should Be Y 



Cartridge Tape Data 
Transfer Error 

Cartridge Tape is not 
ready . 

Cartridge is Write 
Protected . 



Tape is full. Purge the last file or use 
another tape. 

Last transfer using system tape was 
incomplete. 



Magnetic Tape 


N Value 


Meaning 


Pailure N 








*31 


EOT 




SI 2 


EOF 




S73 


Back Space From BOT 




*44 


SIO Failure 




X54 


Unit (7970 for example) 
Failure (7976 also 
supported) 




%1HU 


Channel Failure 



Read or write data error occurred. 



Cartridge may be busy or not inserted. 



Attempted to write data to a protected 
cartridge . 



Channel Failure- 
Device Timeout 

Cartridge Tape 
Hardware Failure 

End of Tape Detected 
on the Cartridge Tape 

Channel Error - GIC is 
not Responding. 

Cartridge Tape Power 
Fail or new Tape 
Inserted 



Cartridge tape timed out. 
Cartridge unit is defective. 



Attempt address or write past the end 
of tape. 

General interface channel (GIC) is 
malfunctioning. 

A Cartridge Tape had a power failure or 
or a new tape was installed. 
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10 INTRODUCTION 



AID is a stand alone program, independent of operating systems, 
which interprets operator statements and commands with emphasis 
on easy communication with I/O devices. HP AID is designed for 
use on HP 3000 Series 30, 33, 10, 4H, and 6H computer syssems 
containing at least 256K bytes of memory, with a device to load 
AID and a keyboard console for operator interaction. 

HP AID consists of statements for writing programs and commands 
for controlling program operation. It is the intent of HP AID to 
provide the operator with the ability to communicate with many 
different I/O devices in an interpretive level language while 
maintaining execution efficiency as if the program was written in 
a lower level language. 



This manual assumes the operator is familiar with the 
Console and terms related to the console (e.g., ENTER). 



keyboard 



For documentation purposes, throughout this manual characters 
output by the computer are underlined to distinguish them from 
user input . 

All references to ENTER will be considered synonymous with 
return/line feed on most Consoles) . 

This manual makes reference to the Diagnostic/Utility System 
which is documented in the Diagnostic/Utility System Reference 
Manual (SECTION I). 



1.1 SPECIAL KEYS 

RETURN 



linefeed 
CTRL 



Must be pressed after every com- 
mand and or statement . It ter- 
minates the line and causes the 
Console to return to the first 
print position. 

Advances the Console one line. 

When pressed simultaneously with 
another key, converts that key to 
a control character that is 
usually non-printing. 
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CTRL H (Bs) or BACKSPACE 



CTRL X (Cn) or DELETE ENTRY 



CTRL If (Em) 



Deletes the previous character in 
a line. The cursor is moved one 
space to the left . 

Cancels the line currently being 
typed. Three exclamation marks, a 
Return and Linefeed are issued to 
the Console (Note - May not apply 
to all Console types). 

Suspends AID program execution, 
reports the statement number cur- 
rently executing and prompts ( > ) . 
See the PAUSE command for further 
action. CTRL Y has no signifi- 
cance in the entry mode except 
during LISTing where it causes 
the listing to terminate. 



LZ PROMPT CHARACTERS 

AID uses a set of prompting characters to signal to the user that 
certain input is expected or that certain actions are completed: 

> The prompt character for AID; an AID command or statement is 
expected. 

? User input is expected during execution of an INPUT(B) 

statement . 
11 Further input is expected during execution of an INPUT 

statement . 



A full line has been deleted with CTRL 
apply to all Console types). 



X (Note- May not 



L3 LOADING THE AID DIAGNOSTIC PROGRAM 

(1) Bring up the Diagnostic/Utility System 
nostic/Utility Disc or Tape. 



(DUS) from 



Diag- 



(2) Enter 'AID' 

(3) AID will display its title message and prompt. 
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1.4 AID COMMANDS AND STATEMENTS OVERVIEW 

1.4.1 Commands 

AID Commands instruct AID to perform certain control functions. 
Commands differ from the statements used to write a program in 
that a Command instructs AID to perform some action immediately, 
while a statement is an instruction to perform an action only 
when the program is executed. A statement is always assigned a 
statement number; a command is not. 

Commands are entered following the prompt character ( > ) . Most 
commands are allowed in either the entry mode or pause mode but 
not both. Each command is a single word that must be typed in its 
entirety with no embedded blanks. Some commands have additional 
parameters to further define command operation. 

For a complete decription of all Commands, refer to section III 

AID Commands. 

1.4.2 Statements 

Statements are used to write an AID program that will subsequent- 
ly be executed. Each statement entered is limited to 80 charac- 
ters and becomes part of the current program which is kept until 
explicitly deleted. 

A statement is always preceded by a statement number. This num- 
ber may be any integer between 1 and 9999 inclusive. The state- 
ment number indicates the order in which the statements will be 
executed. Statements are ordered by AID from the lowest to the 
highest statement number. Since this order is maintained by AID, 
it is not necessary for the user to enter statements in execution 
order. 

Following each statement, ENTER must be pressed to inform AID 
that the statement is complete. AID generates a return- line 
feed, prints the prompt character (>) and next statement number 
on the next line to signal that the statement was accepted. If 
an error was made in the statement, AID will print an error mes- 
sage prior to prompting. ( refer to Error Reporting - para. 2.10) 
AID statements have a semi-free format. This means that some 
blanks are ignored. Imbedded blanks are not allowed in the 
keywords or variables, and keywords and variables must be 
separated by at l^ast one blank . 

> 30 PRINT S VALID 

> 30 PRINT S VALID 

> 30 PRINTS NOT VALID 
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> 30 PRINTS NOT VALID 

> 30 PRINT S VALID 

For a complete description of all statements, refer to Sections 
IV, VIII, IX, and X. 

1.4.3 Changing or Deleting a Statement 

If an error is made before ENTER is pressed, the error can be 
corrected with CTRL H, (He) or the line may be concelled with 
CRTL X (Xc). (refer to paragra 1,1.) After ENTER is pressed, the 
error can be corrected by replacing, modifying, or deleting 
the statement . 

To replace a statement, simply type the statement number followed 
by the correct statement . 

To replace this statement: 

> 30 PRINT X 
retype it as : 

> «0 30 FRINT 3 

or better yet, the MODIFY command may be used: 

> 30 PRINT X 

> 40 M30 

30 PRINT X 



RS 
30 PRINT S 



> U0 (statement 30 is now PRINT S) 

To delete a statement use the following format: 

> 100 DELETE 30 



1-U 



AID Diagnostic Language 



1.5 AID PROGRAMMING STRUCTURES 



Any statement or group of statements constitutes a program. 
The following is an example of a program with only one statement. 

> 100 PRINT " HELLO " 

100 is the statement number. PRINT is the key word or instruc- 
tion that tells AID the kind of action to perform. In this case, 
it prints the string that follows. 

The statement 100 PRINT "HELLO" is a complete program since it 
can run with no other statements and produce a result. However, 
a program usually contains more than one statement . 

These three statements constitute a program: 

> 10 INPUT A,B,C,D,E 

> 20 LET S:=A+B+C+D+E/5 

> 30 PRINT S 

This program, which calculates the average of five numbers, is 
shown in the order of its execution. It could be entered in any 
order if the statement numbers assigned to each statement were 
not changed . 

This program input would execute exactly like the program above: 

> 10 20 LET S:=A*B+C+D*E/5 

> 30 10 INPUT A,B,C,D,E 

> 30 PRINT S 



1.6 LISTING AN AID PROGRAM 

The LIST command can be used to produce a listing of the state- 
ments that have been accepted by AID: 

> HO LIST 

10 INPUT A,B,C,D,E 

20 LET S:=A+B+C+D+E/5 

30 PRINT S 
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Note that the prompt character (>) is not printed in the listing, 
but is printed when the list is complete to signal that AID is 
ready for the next command or statement . 

Any LIST may be terminated with CTRL Y. 

Refer to LIST Command (paragraph 3.13) for other listing func- 
tions . 



1.7 EXECUTING A PROGRAM 

After a program is entered it can be executed with the RUN com- 
mand. RUN will be illustrated with two sample programs. 

The first program contains one statement : 

> 10 PRINT "HELLO" 

When executed, the string HELLO is printed: 

> 20 RUN 
HELLO 

END OP AID USER PROGRAM 

> 20 

When the present AID program is done executing, AID reports with 
"END OP AID USER PROGRAM" before prompting in the entry mode. 

The second sample program averages a group of five numbers. The 
numbers must be input by the user: 

> 10 INPUT A.B,C,D,E 

> 20 LET S:»A+B+C+D+E/5 

> 30 PRINT S 

Each of the letters following the word INPUT, and separated by 
commas, names a variable that will contain a value input by the 
user from the Console. When the program is run, AID signals that 
an input is expected by printing a question mark. The user 
enters the values, separated by commas, after the question mark. 

EXAMPLE: > M0 RUN 

t 7.5.6,8,9 
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AID prints the results : 
7 
END OF AID USER PROGRAM 

> 1»0 

Refer to RUN Command (paragraph 3-21) for further details. 

IS DELETING A PROGRAM 

The program that has been entered may be deleted with the EP 
(Erase Program) command. 

On the previous page, the first program entered was 10 PRINT 
"HELLO". After it has run, it should be erased before entering 
the next program. Otherwise, both programs will run as one, when 
RUN is commanded (i.e., they will run in the order of their 
statement numbers ) . 
For example: > 10 PRINT "HELLO" 

> 20 INPUT A,B,C,D,E 

> 30 LET S:-A*B*C+D+E/5 

> 40 PRINT S 

> 50 RUN 
HELLO 

? 7,5.6.8,9 

7 

END OF AID USER PROGRAM 

> 50 

To avoid confusing results, the following sequence should be 
used: 
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Enter and run the following program: 

> 10 PRINT "HELLO" 

> 20 RUN 
HELLO 

END OF AID USER PROGRAM 

Erase the program as follows : 

> 20 EP 

Confirm you want to ERASE 
current program (Y or N)? Y 
Program Erased 

> 10 

The user's resident program area is now cleared and another pro- 
gram be entered: 

> 10 INPUT A,B,C,D,E 

> 20 LET S:«A*B*C*D+E/5 

> 30 PRINT S 

> 40 RUN 

? 15.25,32.11,27 

22 

END OF AID USER PROGRAM 

> HO 

Unless this program is to be executed again, it can now be erased 
and another program entered. Refer to EP Command (paragraph 3 7) 
for further details. 
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1.9 DOCUMENTING A PROGRAM 



Comments can be inserted in a program with the period ( . ) Special 
Character. Any comment typed after a period will be printed in 
the program listing but will not affect program execution. Com- 
ments cannot be continued on the next line, but as many comments 
as are needed can be entered. 

The previous sample program to average 5 numbers can be docu- 
mented with several comments by using the insert line function: 

> 40 5. THIS PROGRAM AVERAGES 

> 40 7-5 NUMBERS 

> 40 10 INPUT A,B,C,D,E .GET VALUES 

> 40 25. S CONTAINS THE AVERAGE. 

The statement numbers determine the position of the comments 
within the existing program. A list will show them in order: 

> 40 LIST 

5 - THIS PROGRAM AVERAGES 

7 - 5 NUMBERS 

10 INPUT A,B,C,D,E -GET VALUES 

20 LET S:-A+B+C+D+E/5 

25 -S CONTAINS THE AVERAGE 

30 PRINT S 

> 40 



When executed, the program will execute exactly as it did before 
the comments were entered. Refer to the comment statement (Sec- 
tion IV) or the period ( . ) Special Character (Section V) for fur- 
ther details. 
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UO AID OPERATOR MODE STATE DIAGRAM 
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Figure 1.1 — AID Operator Mode State Diagram 
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20 INTRODUCTION 

This section will explain some of the ground rules for handling 
constants, variables and strings. Also included are sections 
covering the basic elements of the Operators and Reserved Vari- 
ables. For more precise definitions of the items covered, refer 
to the sections covering Special Characters, Operators, and Re- 
served Variables. 

2.1 EXPRESSIONS 

An expression combines constants and variables with operators in 
an ordered sequence. Constants and variables represent integer 
values and operators tell the computer the type of operation to 
perform on those integer values . 

Some examples of expressions are: 

P + 5 /27 , 

P is a variable with an assigned value. 5 and 27 are decimal 
constants. The slash (/) is the divide operator. 

If p s »j, the expression will result in the value 2. 
N - R * 5 - T 

N, R, and T contain assigned values. If N = 20, R = 10, and T = 
5, the value of the expression will be 10. 

There is no operator hierarchy and evaluation of expressions is 
executed from left to right. 

2.2 CONTSTANTS 

A constant is either a numeric or a byte. 

NUMERIC CONSTANTS. A numeric constant is a positive or negative 
integer including zero. It may be written in any of the follow- 
ing three forms : 

*As a decimal integer - a series of digits with no decimal 

point . 
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*As an octal integer - a series of digits (but not 8 or 9) 

preceded by a percent (%) symbol. 

"As a hexadecimal integer - a series of digits or letters (A - F 

only) preceded by an exclamation mark 

( !). 

Examples of Decimal Integers: 

(Range is < = INTEGER <= 65536) 

-1472 (unary negate operation) 

*6732 (or 6732) 



19 

65536 (or -1) 

Examples of Octal Integers: 

(Range is <= INTEGER <= S177777) 

S1472 
X6732 
%17 
-S20 (OR X 177760) 

Examples of Hexadecimal Integers: 

(Range is < s INTEGER < ~ IFFFF) 

!F 
!23 

!A (NOTE: A represents the value 10, not the var- 
iable A) 
-!16 (or IFFEA) 

Example of a byte constant: 

"A" or "5" or " ! " 



2.3 VARIABLES 

A variable is a name to which a value is assigned. This value 
may be changed during program execution*. A reference to the 
variable acts as a reference to its current value. Variables are 
represented by a single letter from A to Z. 

A variable always contains a numeric value that is represented in 
the computer by a 16-bit word. 

Variables may be manipulated as decimal, octal, or hexadecimal. 
However, variable type designations( i . e . ! or %) would be used in 
input and output (e.g. INPUT, PRINT) operations only. 
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A decimal variable is identified by the absence of a % or ! 
preceding it : 

G, +G, and -G are decimal variables. 
JG or !G are not decimal variables. 

An octal variable is identified by a preceding percent (?) 
symbol: 

%A and %B are octal variables . 

A hexadecimal variable is identified by a preceding exclamation 
( ! ) mark : 

!K, !G, !Z are hexadecimal variables. 

* All variables are set to zero when a LOAD or RUN command is 
entered. 

2.4 DATA BUFFERS 

Data Buffers are identified by duplicate letters (AA - ZZ) and 
are manipulated as one dimensional INTEGER arrays with the 16-bit 
integer row value defined within parentheses . This row value 
starts at and may be represented by a variable A through Z, any 
Reserved Variable and constants only. Examples of Data Buffer 
elements : 

AA(4), CC(UOO), DD(G), SS(INDEX) 

Data Buffers may be declared up to the user memory available 
(see MAXMEKORY Reserved Variable). 

Once a buffer is declared with a DB statement* it may be manipu- 
lated as a variable in the form of a decimal, octal or hexadeci- 
mal integer**: 

AA(2) is a decimal buffer element. 
%BB(200) is an octal buffer element. 
!FF(1) is a hexadecimal buffer element. 



* If a buffer is not initialized with data the content of any 
element is indeterminate. 

**The octal or hexadecimal notation would be used only in INPUT 
and PRINT type statements. 
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IS STRINGS AND STRING BUFFERS 
2.5.1 Strings 

STRINGS are defined as any number of ASCII characters enclosed by 
quotation marks (i.e. "strings" ) . Any ASCII character (except the 
quotation mark) is allowed within the string. 

ZS2 String Buffers 

STRING BUFFERS are byte-oriented one-dimensional arrays used to 
manipulate STRINGS. These buffers are identified by duplicate 
letters (AA to ZZ) preceded by an ampersand (&) and are limited 
to the available user memory (see MAXMEMORY Reserved Variable). 
The element of a buffer is enclosed in parentheses and defines 
the byte to be manipulated. This element may be represented by a 
variable A through Z, a Reserved Variable or constant only. Ex- 
amples of STRING BUFFER elements are: 

&AA(5) identifies byte 6 of buffer &AA (index is the 
first element) 

&CC(20) identifies byte 21 of buffer iCC 
&GG(X) identifies byte X ♦ 1 of the buffer &GG 

Bytes are packed left- justified so that word one of a buffer 
contains : 



I I ! 

I BYTE | BYTE 1 | 
J I I 



STRINGS within STRING BUFFERS may be altered by using starting 
and ending byte indicators: 

&AA( STARTING BYTE, ENDING BYTE) 

The following examples will display some of the rules in 
manipulating STRING BUFFERS: 

> 10 PRINT &AA(10) .PRINT BYTE 10 OF THE 4AA BUFFER 

> 20 PRINT &AA(10, 20) .PRINT BYTES 10 THROUGH 20 OF &AA 

> 25 -ANY EXPRESSION RESULT MAY BE STORED INTO A BYTE 

> 30 LET &AA(2) :»B+»60 

> 35 .ONLY SINGLE CHARACTER STRINGS ARE ALLOWED IN AN EXPRESSION 
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> HO LET &AA(K) :="B"+C 

> 15 .ALL MULTIBYTE STRING ASSIGNMENTS MUST BE OF EQUAL LENGTH 

> 50 LET &AA(2,5):'"ABCD" 

> 55 .THE FOLLOWING STATEMENTS WOULD GENERATE ERRORS 

> 60 LET &AA(2,3):*B*%60 .LET &AA(2,3) MUST BE STORED WITH 

"XX" 

> 60 LET &AA(U);*"BC"*C ."BC" NOT ALLOWED IN EXPRESSIONS 

> 60 LET &AA<2,6) :*"ABCD" .&AA(2,6) IS EXPECTING 5 CHARACTER 

> 60 LET &AA(0):=&AA(1):="B" .MULTIPLE STRING ASSIGNMENTS 

> 60 LET &AA(2,5):»&BB(7,10) :="ABCD" .NOT ALLOWED 

2.6 OPERATORS (OVERVIEW) 

An operator performs an arithmetic or logical operation on one or 
two values resulting in a single value. Generally, an operator 
has two operands, but there are binary operators that precede a 
single operand. For instance, the minus sign in A-B is a binary 
operator that results in subtraction of the values; the minus 
sign in -A is a binary operator indicating that A is to be 
negated. 

The combination of one or two operands with an operator forms an 
expression. The operands that appear in an expression can be 
constants, variables or other expressions. 

Operators may be divided into types depending on the kind of 
operation performed. The main types are arithmetic, relational, 
and logical (or Boolean) operators. 

The arithmetic operators are: 

+ Integer ADD (or if unary, no operation) A * B (or +A) 
Integer Subtract (or if unary, negate) A - B (or -A) 
* Integer Multiply A * B 

/ Integer Divide A / B 

MOD Modulo; remainder from division A MOD B produces 

the remainder from 
A / B 

In an expression, the arithmetic operators cause an arithmetic 
operation resulting in a single integer numeric value. 
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The relational operators are: 

Equal A ■ B 

Less Than A < B 

Greater Than A > B 

Less Than or Equal To A < = B 

Greater Than or Equal To A >• B 

Not Equal A < > B 

When relational operators are evaluated in an expression they 
return the value -1 if the relation is found to be true, or the 
value if the relation is false. For instance, A » B is evalu- 
ated as -1 if A and B are equal in value, or as if they are 
unequal . 

The following examples demonstrate the difference between rela- 
tional operators and special relational operators in expression 
evaluation: 

10 LET B:-6 10 LET B:»-10 

20 IF 1<B<100 THEN 500 20 IF 1<B<100 THEN 500 

IS EVALUATED AS IS EVALUATED AS 

1<6 - TRUE (-1) 1<-10 - FALSE (0) 

(-1)<100 - TRUE (-1) (0)<100 * TRUE {-1) 

RESULT "TRUE" RESULT "TRUE" 

Note that using relational operators does not work in this type 
of application. However, consider the evaluation of special rela- 
tional operators: (Refer to Special Relational Operators (Section 
VI regarding the Special Operators EQ, LT, GT, LE, GE, and NE. ) 

10 LET B:=6 10 LET B:--10 
20 IF 1 LT B LT 100 THEN 500 " 20 IF 1 LT B LT 100 THEN 500 
IS EVALUATED AS IS EVALUATED AS 

1<6 » TRUE (-1) K-10 = FALSE (0) 

6<100=TRUE (-1) -10<100-TRUE (-1) 
TRUE AND TRUE = TRUE TRUE AND FALSE » FALSE 

RESULT "TRUE" RESULT "FALSE" 



The Logical or Boolean operators are : 

AND Logical "and" A AND B 

OR Logical "inclusive or" A OR B 

X0R Logical "exclusive or" A XOR B 

NOT Logical complement NOT A 

Unlike the relational operators, the evaluation of an expression 
using logical operators results in a numeric value which is 
evaluated as true (non-zero but not necessarily -1) or false 10) 
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The Shift Operators are: 

LSL or LSR Logical Shift X LSL n (where n is any variable 

or constant) 
ASL or ASR Arithmetic Shift X ASR n 
CSL or CSR Circular Shift X CSL n 

For further descriptions of Operators, refer to Section VI. 

2.7 RESERVED VARIABLES (OVERVIEW) 

AID reserves special locations for variables that may commonly be 
used or accessed from a known area. These locations are assigned 
names which become Reserved Variables. Reserved Variables may be 
altered or accessed as a variable (i.e. like A thru Z), however, 
caution must be used since some Reserved Variables are altered by 
commands and statements . The following list briefly describes 
those Reserved Variables and the operations that change them. 

NORESPONS - If >0 then altered during bad I/O operation. 

BADINTF - Altered by an illegal device interrupt. 

CONCHAN - Set to the system console channel device. 

FILELEN - Set to file length after FILENAME. 

FILEINFO - Set to file information after FILENAME. 

INPUTLEN - Set to character input length during INPUT. 

MAXMEMORY - Altered during DB and BSIO/ESIO execution. 

TRUE - Stored with -1 at run time. 

INDEX - During a CB statement, set to -1 if the buf- 
fers compare; otherwise the element number (of 
the first buffer) which did not compare. 

PASSCOUNT - Optionally incremented by the BUMP statement. 

RUNPARAM1/3 - Set to the value of any parameters passed with 
the RUN command; otherwise 0. 

G0PARAM1/3 - Set to the value of any parameters passed with 
the GO command; otherwise 0. 

OFFSET - Set to after a RETURN statement. 

NOINPUT - Set to true with a SNPR command or false with 
an ENPR command . 

SECTI0NS1/3 - Set to the appropriate bit mask combination of up 
to 18 section numbers input with the TEST 
command; otherwise set to all "ones" at run time. 

NEWTEST - Set to true if a TEST command is entered with 

parameters and set to false after a TEST command 
without parameters . 

SECTION - Set to the section number of a SECTION statement 
(if the SECTION is executed). 

N0RESPNS2 - If NONESPNS >0 then N0RESPN2 is possibly altered 
during bad I/O operation. 

STATENUM - Set to current AID statement number when ever a 
function call is executed. 

All other Reserved Variables are set to zero at run time. For a 
description of each Reserved Variable refer to Section VII. 
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2J OPERATOR INPUT MODES 

Three modes of operator input are available. These modes, 
discussed next in detail, are entry, execution and pause. 

2JU Entry Mod* Input 

Anytime a program is not executing or in a pause mode, AID is in 
the entry mode. Entry mode is identified by a prompt (>) and the 
next sequential statement number. 
Example: > 10 

In this mode, the operator may enter any valid statement or 
command. 

2X2 Execution Moo* Input 

Anytime a program is executing, there are two inputs allowed: 

(1) CONTROL Y - Initiates a break at the end of the currently 
executing statement and a message identifying that statement 
number. 

Example: Break in Statement 20 



At this point any pause type entry may be made. (Refer to 
paragraph 2.8.3-) 

(2) INPUT Statement Execution - When an INPUT or INPUTB statement 
is executed, a question mark is prompted. Any valid numeric 
or alpha input(s) will be accepted. Each input must be 
separated by a comma if multiple inputs are requested. 

Example: INPUT THREE NUMBERS 

? !1P,*37,10 



2.8.3 Paus* Mode Input 

Anytime a CONTROL Y interrupt* or pause-type statement has oc- 
curred, AID prompts with (>) and no statement number. At this 
point the operator may enter any valid command which affects pro- 
gram execution or control except EP, REN, SAVE, LOAD, SET, 
DELETE, PURGE, INC and MODIFY. Program alteration is not allowed, 
but the operator may display any LIST data. 

For further explanations, see the operator mode state diagram 
(figure 1.1) or refer to the various statements and commands for 
input restrictions. 
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An interrupt during an I/O operation is indicated by the 
message : 

Internal Break in Statement 10 



(Any pause mode input except 
when this occurs) 



LIST, CREATE and LF may be made 



:.» PROGRAM EXECUTION 

After the RUN command is issued AID must do some house cleaning 
before turning over control to execution of the program. This 
may cause a slight delay in the initial pass of the resident pro- 
gram, but subsequent passes will not be delayed. Also, during 
this house cleaning, errors may be detected that could abort the 
program (e.g. a referenced statement number is missing). 

Assuming all goes well in the house cleaning, execution com- 
mences. If an AID error occurs during execution, the program may 
abort and AID will return to the entry mode. 

The programmer should be aware of statements that cause large 
amounts of time to execute in case time is an important consider- 
ation (e.g.,DB of a predeclared buffer which, causes a pack of the 
buffer area). And, he should be aware of statements that consume 
large amounts of user area in case memory is a critical factor 
(e.g., Comments). A list of memory allocation and approximate 
execution times of statements is provided in paragraph 2-11. 

If the program does not loop, it will exit and print "END OF AID 
USER PROGRAM" and a prompt to indicate AID is in the entry mode. 

If the program loops or runs indefinitely, the only way to abort 
it is to interrupt (Control Y )and, after the prompt character is 
printed, enter the EXIT command. 

2.10 ERROR REPORTING 

Three types of errors may be reported to the operator: entry 
mode errors, execution mode errors and program detection errors. 
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1.10.1 Entry Mode Errors 

If an error is detected in a statement or command just input, AID 
prints a circumflex ( ) under, or in the vicinity of, the char- 
acter that generated the error and then prints an error message. 

Example: > 10 LET A:=S384 

ENTRY MODE ERROR 

ARITHMETIC ERROR ( OVERFLOW, DIVIDE BY 

, NUMBER TOO LARGE , ETC . ) 

> 10 

The error message implies the octal digit was illegal. 

2.10.2 Execution Mode Errors 

If a failure is detected during program execution which might 
cause a catastrophic failure in AID, the resident program is us- 
ually aborted and an error message is reported identifying the 
faulty statement. 

Example: > 10 LET AA(H):=B 

> 20 RUN 

EXECUTION MODE ERROR IN STATEMENT 10 

UNINITIALIZED DB 

END OF AID USER PROGRAM 

> 20 

The error indicates the buffer accessed has not been declared 
with a DB statement . 

2.10.3 Program Detection Errors 

These errors are detected by the user program and will not cause 
a catastrophic failure in AID. Documenting the errors would be 
the responsibility of the program writer. 
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Example: INPUT A LETTER 
? 4 
BAD INPUT, I SAID A LETTER. TRY AGAIN! ! 



2.11 STATEMENT MEMORY ALLOCATION AND EXECUTION TIME 

2.11.1 Statement Memory Allocation 

Every statement uses a minimum of three words of user area. 
addition, any parameters entered occupy the following space: 

Parameter Word(s) Used 



In 



Operators ( + , - , MOD, etc . ) 

Special Characters (!,%) 

Constants 

Variables (A-Z) 

Reserved Variables (PASSCOUNT, etc . } 

Strings ("ABC") 

Data Buffers (AA(x)) 

String Buffers (&AA(x)) 

String Buffers (&AA(x,y)) 



1/2 

1/2 

1-1/2 

1-1/2 

1-1/2 

l+(char.lngth/2)* 

3-1/2 

3-1/2 

5-1/2 



Comments 



l*(char.lngth/2)* 



* Strings or comments containing character strings with more than 
four repetitive characters will consume less space because the 
repetitive string is packed into two words (i.e., "ABCDEFGH" 
would require four words and "••••«•••■■ would require two). 
Note also that alternate spaces are packed into bits (i.e. " A 
B C D" would require two words but "ABCDEFGH" would require 
four) . 



From the table above a few helpful hints arise: 

- Use variables or Reserved Variables instead 
possible. 



of buffers when 



Use strings, string buffers and comments sparingly. If 
strings must be used, look for a trade-off in space (i.e. if a 
string containing more than about six characters will be used 
repeatedly, it might be beneficial to assign that string to a 
string buffer for further manipulation or printing) . 

A comment following a statement text consumes three words less 
than a comment statement. 
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Example: > 10 .SAVE XYZ VALUE 

> 20 LET A:=AA(«) 

The following statement usage saves three words : 

> 10 LET A:=AA(U) .SAVE XYZ VALUE 

- Although it is not obvious from the table above, chaining LET 
statements saves a minimum of three words for each assignment 
and greatly enhances execution time. 

Example: > 10 LET A:=U 

> 20 LET B:=5 

> 30 LET C:=5 

The following statement usage saves six words: 

> 10 LET A:-«.B:*5,C:«5 

The following statement saves seven and a half words : 

> 10 LET A:=K ,B:*C:=5 

- Savings are also derived by nesting LET statements in other 
statements when allowed. 

Example: > 10 LET A: -4,B : =5 .C: =6 

> 20 FOR A STEP B UNTIL C 

The following statement usage saves seven words : 

> 10 FOR A:»H STEP B:=5 UNTIL C:=6 

ZiU Execution Tims 

Each statement requires about twenty machine instructions to 
start executing. This overhead is required for setting up cer- 
tain parameters required for all statements. 

Once a statement actually starts executing it may require as few 
as two machine instructions (e.g., SUPPRESS , ENABLE ) or thousands 
to execute (e.g, DB, where the buffer has been defined 
previously) . 
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Since the "Time to Execute" to "Time of Execution" ratio of most 
statements is relatively high, it would behoove the programmer to 
compact multiple statements into one. 
Example: 

> 10 .START THE XYZ TEST 

> 20 LET A:-U 

> 30 LET D:-55 

> 10 FOR A STEP 3 UNTIL D 



The above can be condensed into the following single statment: 

> 10 FOR A:-1 STEP 3 UNTIL D:«55 .START XYZ TEST 

The first set of statements takes at least 96 machine instruc- 
tions more to execute where: 

Statement 10 costs 6+ 
Statement 20 costs «5+ 
Statement 30 costs 15* 

96* 

Here are some more time saving hints for programming in AID: 

* Comment statements cost 20 machine instructions where comments 
in statements cost nothing in execution (see previous example). 

* FOR-NEXT loops are much faster than IF-THEN loops 
Example: > 10 FOR A:»0 UNTIL 10 

> 20 LET AA(A):=A 

> 30 NEXT 10 

The above statements will execute much faster than the 
following: 
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> 10 LET A:«-l 

> 20 LET AA(A):*A:-A+1 

> 30 IF A <- 10 THEN 20 

• DB statements of previously defined buffers are very expensive 
because of the packing required for dynamic buffer allocation 
and should therefore be used sparingly. 



Example: 



> 10 DB AA. 20 



>100 DB AA.10 .VERY EXPENSIVE 
HINT: If space is available use another buffer. 

Example: > 10 DB AA.20 

>100 DB BB.10 

* Chain assignments whenever possible. 
Example: > 10 LET A: =H 

> 20 LET B:=5 

> 30 LET C:»5 

May be rewritten to save at least 70 machine instructions as 
follows: 

> 10 LET A:=U,B:=5,C:«5 

or even greater savings may be realized by: 

> 10 LET A:=U.B:=C:=5 

* Because of inter-statement overhead, transfer of control should 
be made to the exact destination. 
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Example: > 10 GOTO 50 



> 50 .BEGIN XYZ TEST 

> 60 SECTION U,300 

Although harmless in appearance, the GOTO 50 should bypass any 
unnecessary or non-executable comments. The most efficient 
code would be: 

> 10 GOTO 60 



50 .BEGIN XYZ TEST 
60 SECTION U.300 



or better 

> 10 GOTO 50 



50 SECTION «,300 .BEGIN XYZ TEST 
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AID COMMANDS I | | 

II III I 



3.0 INTRODUCTION 

The AID Commands available to the operator are listed, in detail, 
in this section. The format for each command explanation is: 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

ALLOWED IN: 

EXAMPLES : 



General phrase of what the Command does . 

The form that the Command would be called in. 



A detailed explanation of the 
function. 



Command ' s 



Describes whether the command is allowed in the 
Pause Mode, Entry Mode or both. 

One or more examples using the Command. 



3.1 CREATE 



OPERATION NAME: Create a new file 



MNEMONIC : 

ALLOWED IN: 
DESCRIPTION: 



EXAMPLE(S): 



CREATE filename, number 



of 
OR 



sectors [.revision] 



number of words divided 
by 128, for DUS on tape 

Entry Mode or Pause Mode but not Internal 
Mode (See Pause Mode Input) 



Break 



Creates, i.e., adds to the directory of files of 
the Diagnostic/Utility disc or tape, a Data file 
"filename" which will be the "number of sectors" 
for disc or "number of words divided by 128" for 
tape. The range on the number of sectors is 1<« 
sectors <=available sectors left on the disc. Re- 
fer to DUS Reference Manual (p/n 30070-900D3) - 



10 CREATE TEST, 4 



(creates the Data file TEST 
with a length of U sectors 
(disc) or 512 words (tape). 
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33. DELETE 

OPERATION NAME: 
MNEMONIC : 

ALLOWED IN: 
DESCRIPTION: 



EXAMFLE(S): 



Delete statement ( s ) 

D[ELETE] first statement number [/last statement 
number. 

Entry Mode Only 

Removes the statement specified in first 
statement number from the user program. If the 
last statement number parameter is entered then 
the statements from first to last statement 
number are deleted. 

> 100 DELETE 20 (remove statement 20) 



100 D30/40 (remove statements 30 through U0) 



3.3 EEPR 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

ALLOWED IN: 
EXAMPLE(S): 



Enable Error Printout 
EEPR 

Enables AID to print error messages*. This is a 
default condition and would normally be used 
only after a previous SEPR Command. 

NOTE: Default is error print enabled. 
Pause Mode Only 

> 110 RUN 
(CONTROL Y> 

Break in Statement 80 

> EEPR (ENABLE ERROR PRINTOUT) 



• These messages are those contained in the EPRINT and PRINTEX 
Statements only. 
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OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 
EXAMPLE(S) : 



Enable Error Pause 

EEPS 

Enables AID to generate an error pause* after an 
error. This is a default condition and would 
normally be used only after a previous SEPS. 

NOTE: Default is error pause enabled. 

Pause Mode Only 

> 110 RUN 
(CONTROL Y) 

Break in Statement 20 

> EEPS (ENABLE ERROR PAUSES) 



" These pauses are those contained in the the EPRINT and EFAUSE 
Statements only. 



35 ENPR 

OPERATION NAME: Enable Non-Error Printout 

MNEMONIC ; ENPR 

DESCRIPTION: Enables non-error messages* to be printed and 
operator response to a message to be acknow- 
ledged. This is a default condition and would 
normally be used only after an SNPR Command was 
previously entered. ENPR sets the Reserved Vari- 
able NOINPUT to false. 

VOTE: Default is non-error print enabled. 

ALLOWED IN: Pause Mode Only 
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EXAMPLE(S) : > 50 RUN 

(CONTROL Y) 

Break in Statement 10 

> ENPR (Enable Non-error Print) 



* These messages are those contained in the PPRINT and PRINT 
Statements only. 



3* ENPS 

OPERATION NAME: Enable Non-Error Pauses 
MNEMONIC : ENPS 



DESCRIPTION: 

ALLOWED IN: 
EXAMPLE(S) : 



Enables non-error pauses* during AID program 
execution. This is a default condition and 
would normally be used only after a SNPS command 
was previously entered. 

NOTE: Default is non -error pause enabled. 

Pause Mode Only 

> 50 RUN 

(CONTROL Y) 

Break in Statement 10 



> ENPS 



(Enable Non-Error pauses again) 



* These pauses are those contained in PPRINT and PAUSE Statements 
only. 
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3.7 EF 



OPERATION NAME: Erase Program 

MNEMONIC : EP 

DESCRIPTION: Erases the resident AID program from memory. 

ALLOWED IN: Entry Mode Only 

EXAMPLE(S): > 100 .LAST LINE 

> 110 EP 

CONFIRM YOU WANT TO ERASE THE CURRENT PROGRAM 
(Y OR N) 
? Y 

PROGRAM ERASED (If this message does not appear 
the program is intact.) 

> 10 

3.8 EXIT 

OPERATION NAME: Leave Program Execution 
MNEMONIC : EXIT 

DESCRIPTION: Stops AID program execution and returns to the 
entry mode . If AID is in the entry mode , then 
EXIT returns to the Diagnostic/Utility System. 

ALLOWED IN: Pause Mode or Entry Mode 

EXAMPLE(S): > 50 RUN 

(CONTROL Y) 

Break in Statement 30 

> EXIT 

END OF AID USER PROGRAM 
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> 50 



(READY FOR NEXT STATEMENT) 



-or- 

> 100 EXIT 

CONFIRM YOU WANT TO ERASE THE CURRENT PROGRAM 

(Y OR N) 

? Y (a N response will return the operator to 
the AID entry mode) 



Enter Program Name 

3.9 GO 

OPERATION NAME: Continue Execution 
MNEMONIC: GO [Gl] [ , [G2] [ ,G3] ] 



DESCRIPTION: 



ALLOWED IN: 
EXAMPLE(S): 



Causes the present AID program to continue from 
the point at which it paused . Up to three para- 
meters (G1/G3) may be passed which are accessi- 
ble by the program with the G0FARAM1/3 Reserved 
Variables (additional parameters are ignored). 
The parameters are delimited by commas and are 
assumed to be decimal integers unless preceded 
by a % or ! (see Special Characters). Default 
parameters are assigned the value 0. 

Pause Mode Only 



> 100 RUN 

DISC NOT READY, READY DISC AND CONTINUE 

> GO 



(PROGRAM EXECUTION CONTINUES G0PARAM1 
THROUGH GOPARAM3 EQUAL 0) 



or 



> GO,, 2 (THE THIRD PARAMETER (G0PARAM3) IS 2 
AND THE REST ARE 0) 



> GO 8 (THE FIRST PARAMETER (G0PARAM1) IS 8) 
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OPERATION NAME: Change Statement Increment 



MNEMONIC : 
DESCRIPTION : 



ALLOWED IN: 
EXAMFLE(S): 



INC X 

Allows the operator to change the statement in- 
crement value without renumbering (see REN Com- 
mand). The new value X will take effect after a 
valid statement is entered with a number greater 
than or equal to the existing statement number. 

Entry Mode Only 

> 10 LET A:-« 

> 20 INC 1 

> 20 GOSUB 200 

> 21 (Note- increment is by one and not 
ten) 



311 LC 

OPERATION NAME: List Commands 



MNEMONIC : 
DESCRIPTION : 

ALLOWED IN: 



LC 

Lists the commands that are available in AID. 
The entry mode and pause mode commands are 
listed depending on the mode AID is in at the 
time of the LC command. 

Pause Mode or Entry Mode 



EXAHPLE(S): > 10 LC (Lists the entry mode AID commands) 
or 
Break in Statement 50 
> LC (Lists the Pause mode AID commands) 
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3.12 LF 

OPERATION NAME: List Files 
MNEMONIC: LF [P[RINTER]] 



DESCRIPTION: 

ALLOWED IN: 
EXAMPLE(S): 



Lists the files that reside in the Diagnos- 
tic/Utility System directory. For further infor- 
mation refer to the Diagnostic/Utility System 
Reference Manual. 



Entry Mode or Pause Mode but not Internal 
Mode . ( See Pause Mode Input . ) 



Break 



> 10 LF (Refer to Diagnostic/Utility System 
Manual for printout information.) 



313 LIST 



OPERATION NAME: 



MNEMONIC : 



LIST 

L[IST] [P[RINTER]] [DATA TYPE) 
number] 



[statement 

[R] 

(V] 
[B] 
[C] 



ALLOWED IN: Entry Mode or Pause Mode, but not Internal Break 
Mode . ( See Pause Mode Input . ) 

DESCRIPTION: Will print the information requested to the con- 
sole device. If the optional [PRINTER] is 
entered the LIST will be printed on the printer 
device. If DATA TYPE is specified the listing 
will be in that type (i.e., i for hex, * for 
octal else decimal). Any LIST may be terminated 
with CTRL Y. 
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Listing formats are: 

Entry 

LIST [x/y] 



LIST C 
LIST R [,x] 



Meaning 

List the present AID program, x 
causes a one line list of statement 
x. y causes a multi-line list of 
statements x through y. 

List the value of PASSCOUNT. 

List the Reserved Variables. 

If x is entered then list only that 

Reserved Variable. 



I WARNING I 



The reserved variables VALUE1 to VALUES and 
NAME1 to NAME6 contain information that is 
pertinent only to the use of the FUNCTION 
statement. 



LIST V [,x] 



Entry 

LIST B [,x,y/z] 



List the variables as follows: 

If x is not entered then list all 
variables (A - Z). If x is entered 
then list only that variable. 

Meaning 

List Buffers as follows : 
If only B is entered, then list all 
buffers and their lengths in the 
order of the statement numbers where 
a DB or BSIO occurs. If x is entered, 
list the entire contents of buffer x 
(If x is a string buffer then list in 
ASCII with a header that designates 
the character numbers ) . With data 
buffers if y is entered, list only 
that element of buffer x. If z is 
entered, list all elements of buffer 
x from y to z. 



EXAMPLE* S): SAMPLE PROGRAM LIST 

> 60 LIST 

> 10 .XYZ DIAGNOSTIC 

> 20 .WHAT 
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> 30 .A 

> 40 .FUNNY 

> 50 .PROGRAM 

> 60 



SAMPLE VARIABLE LIST 
> 110 RUN 



(CONTROL Y) 

Break in Statement 10 



> LIST!V,A 
A - !P6 

> LISTXV.F 

F - «66 

> LIST V 

A • 246 B - 10 C ' 43 D - 4 
.... Z » 94 



SAMPLE DATA BUFFER LIST 
> 200 RUN 



(ATTENTION) 

Break in Statement 40 

> LIST B 

STATEMENT NAME SIZE 

40 AA 20 (AA is 20 words long) 

100 &BB 6 (&BB is 6 bytes long) 
150 DD *SI0 # (DD is declared as BSIO DD. It's 

length is indeterminate) 

> LIST B,AA • Will list the 20 elements of AA 
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AA(0) = 4« 
AA(8) = 76 
AA(16) = 5 



26 

in 

10 



>LIST B,AA,l/3 



77 31 

. Will list elements 1-3 of AA 



13 
10 



AA(1) =26 U U 

>LIST PRINTER B (Will list all presently defined 

buffers on the Printer Device) 
SAMPLE STRING BUFFER LIST 

Any character outside the range !20<=character value<!7E 
will be replaced with a circumflex ( ) for continuity 
in listing (i.e. characters 20 and 21 in the following 
example are a carriage return and a linefeed). 



>LIST B.&BB 



(Will list a header which identifies 
each character position in the 
string in increments of 70 (i.e. in 
the following example the character 
D is in the 70th character position) 
and then lists the contents of the 
&BB buffer) 



10 



20 



60 



69 



JKLMNOPQRSTUV 



DEF 



3J4 LOAD 

OPERATION NAME : Load Program 
MNEMONIC: LOAD filename 



DESCRIPTION: Allows the operator to load an AID program from 
tape (see the SAVE command). Any statements 
entered before the LOAD are erased and when the 
program is loaded AID responds with a normal 
prompt with the next sequential statement number 
following the loaded program. 
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ALLOWED IN: Entry Mode Only 

EXAMPLE(S): Assume the AID program on the DUS media ends at 
statement 1270. 

> 110 LOAD TESTPROG (INITIATES A READ FROM THE 
DUS MEDIA) 

CONFIRM YOU WANT TO ERASE THE PROGRAM (Y OR N) 

? Y (A "Y" RESPONSE WILL ERASE THE 

CURRENT PROGRAM AND LOAD THE NEW 
PROGRAM, AND A "N" RESPONSE WILL 
CAUSE NO ACTION TO OCCUR). 

Program Loaded 

The Next Available Statement Number is 

> 1280 

(LOAD SUCCESSFUL. THE AID PROGRAM TESTPROG ON DISC OR 
TAPE IS NOW IN MEMORY AND ANY VALID STATEMENT OR 
COMMAND MAY BE ENTERED) . 



3.15 LOOP 

OPERATION NAME: Set Loop Flag 

MNEMONIC : LOOP 

DESCRIPTION: Sets a LOOP flag that, during program execution, 
will cause a LOOPTO statement branch to occur 
(See the LOOPTO statement). See the LOOPOFF com- 
mand for resetting this flag. 

ALLOWED IN: Pause Mode Only 

EXAMPLE(S): > 100 SECTION 1,200 

> 200 SECTION 2,500 

> 500 LOOPTO 100 .Branch to Section 1 if LOOP 
commanded 
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3.16 LOOPOFF 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

ALLOWED IN: 



3.17 MODIFY 
OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 
EXAMPLE(S): 



Clear Loop Flag 

LOOPOFF 

Clears the LOOP flag that was set by 
command. See LOOP command. 

Pause Mode only. 

(CONTROL Y) 

Break in Statement 200 



the LOOP 



> LOOPOFF (clear LOOP flag meaning exit 
AID program normally upon 
completion) 



Modify Statement 

M[ODIFY] Statement Number [/Statement Number] 

Provides a means of editing the ASCII text of a 
statement . When the MODIFY command is entered 
with an existent statement number AID lists the 
statement. Any character editing may now be 
done by entering a key letter under the column 
to be edited. This editing feature allows in- 
serting, replacing or deleting characters. Af- 
ter the edit is complete the operator may delete 
the old statement number and add the new by 
simply pressing ENTER, or he may leave the old 
statement intact and add the new by entering "J" 
(meaning JOIN) . If more than one edit type is 
entered only the first edit type is acknow- 
ledged. Any modify may be aborted by entering 
"A". 

Entry Mode Only 

> 100 M10 



10 LET k-.'H 

IA(0) (INSERT A(0)) 
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10 LET AA(0):=M 

RFOR (REPLACE LET WITH FOR) 

10 FOR AA(0):=U 

DDDD (DELETE FOR ) 

10 AA(0):«4 
(ENTER) (REPLACES STATEMENT 10) 

> 100 



Examples (continued) 
> 100 M30 





30 


.ABC 




R50 






50 


.ABC 


(ENTER) 


> 


100 




> 


100 


H50 




50 


.ABC 




Rl 






150 


.ABC 


J 






> 


160 





(DELETES STATEMENT 30, ADDS STATEMENT 50) 



(PRESERVES STATEMENT 50, ADDS STATEMENT 150) 



3.M PURGE 



OPERATION NAME: Purge a File 
MNEMONIC: PURGE filename 



DESCRIPTION: 

ALLOWED IN: 
EXAMFLE(S): 



Removes the file "filename" from the Diagnos- 
tic/Utility System directory. See the Diagnos- 
tic/Utility System Reference Manual for details. 
Entry Mode only. 



> 10 PURGE TEST 



(Remove the file TEST from the 
directory) 
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3.19 REN 



OPERATION NAME: Renumber Statements 



MNEMONIC : 



REN [c] 

where c»( statement multiple 
ten (10). 



>»1 and default is 



DESCRIPTION: Renumbers the existing statements as specified 
by the statement multiple. If the renumbering 
will exceed 9999 an error is reported and a new 
number must be entered. All references to State- 
ment numbers are also changed to reflect the new 
Statement numbers . 



ALLOWED IN: 



Entry Mode Only 



EXAMPLE(S) : 



> 10 




> 20 


GOTO 30 


> 30 


PAUSE 


> 40 


REN 


> 40 


LIST 


> 10 




> 20 


GOTO 30 


> 30 


PAUSE 


> 40 


REN3 


> 12 


LIST 


> 3 




> 6 


GOTO 9 


> 9 


PAUSE 


> 12 





(DEFAULTS TO STATEMENT INCREMENTS 
OF 10 - WHICH MEANS THE PROGRAM 
DOESN'T CHANGE IN THIS EXAMPLE) 
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3.20 EST 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 



Reset 

RST 

Resets all execution state flags to the default 
state: 

- Error Pause is enabled (EEFS Command) 

- Error Messages unsuppressed (EEPR Command) 

- Non-Error Messages unsuppressed (ENPR Command) 

- Non-Error Pauses enabled (ENPS Command) 
Pause Mode Only 



3.21 RUN 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 



Initiate Execution 

RUN [Pl],[, [P2][, [P3]]] 

Causes the resident AID program to initiate exe- 
cution from the lowest numbered statement re- 
gardless of the state of execution. Up to three 
parameters (P1/F3) may be passed into the 
RUNPARAM1/3 Reserved Variables for use by the 
program (additional parameters are ignored). The 
parameters are delimited by commas and are 
assumed to be decimal integers unless preceded 
by a % or ! (see Special Characters). Default 
parameters are assigned the value 0. AID resets 
all variables, buffer pointers and indicators to 
their default values except the LOOP and TEST 
flags and information. 

Pause Mode or Entry Mode 
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.RUNPARAM1 THRU RUNPARAM3-0 



> 100 RUN 
(CONTROL Y) 

Break in Statement 20 

> RUN 

This sequence would restart program execution 
-- or -- 

> RUN 1,,3 (THE FIRST PARAMETER (RUNPARAM1) IS 

ASSIGNED THE VALUE 1 AND 

THE THIRD (RUNFARAM3) THE VALUE 3) 



322 SAVE 

OPERATION NAME: Save Program 

MNEMONIC: SAVE filename [.revision level] 



DESCRIPTION: Allows the operator to save the resident AID 
program, in binary, on the DUS media (also 
see the LOAD command). Nothing is altered in 
the AID program and, after the SAVE is 
completed, AID returns to the entry mode. If 
the optional revision level is entered filename 
will have that revision. If no revision is 
entered filename will be assigned a 00.00 re- 
vision level. 

NOTE: If room does not exist on the flexible 
disc for the file, the message "Insufficient 
disc space" is displayed. Since going to DUS 
will cause the current AID program to be lost, 
follow this recovery procedure: 

(1) Insert another Diagnostic/Utility flexible 
disc which has more space 



(2) 



SAVE the current AID program on the 
flexible disc 



second 



(3) Re-insert the original Diagnostic/Utility 
media 
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(4) Use PACK command to attempt to open-up 
space 

(5) Re-insert the second Diagnostic /Utility 
media 

(6) LOAD the program 

(7) He-insert the first Diagnostic /Utility 
media 

(8) SAVE the program 

ALLOWED IN: Entry Mode Only 

EXAMFLE(S): > 1280 SAVE TEST, 01.02 

PROGRAM SAVED (ANY OTHER MESSAGE INDICATES 
NO SAVE OCCURRED) 

> 1280 (SUCCESSFUL SAVE! ANY VALID COMMAND 
OR STATEMENT MAY BE ENTERED) 

323 SEPR 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

ALLOWED IN: 
EXAMFLE(S): 



Suppress Error Printout 

SEPR 

Suppresses error messages and error pauses* 
until an EEPR or RST command is acknowledged . 
NOTE: Default is error print enabled. 

Pause Mode Only 

> 110 RUN 

(CONTROL Y) 

Break in Statement 20 



> SEPR 



These error messages and error pauses are those contained 
the EPRINT and PRINTEX Statements only. 
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OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

ALLOWED IN: 
EXAMPLE(S): 



AID Diagnostic Language 



Suppress Error Pause 

SEPS 

Suppresses error pauses* from occurring. The RST 
and EEPS Commands will override this condition. 

NOTE: Default is error pause enabled. 

Pause Mode Only 

> 110 RUN 



(CONTROL Y) 

Break in Statement 50 

> SEPS 



These pauses are those contained 
statements only. 



in the EPRINT and EPAUSE 



325 SET 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 



Set New Statement Number 

SET Statement Number 

Allows the operator to set the current statement 
number to any valid statement number. If an 
existing statement number is encountered while 
sequencing because of the SET command a warning 
message is issued which informs the operator 
that a valid statement entry will delete the 
existing statement. 

Entry Mode Only 
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EXAMPLE(S): > 10 LET A:=« 

> 20 INC 1 

> 20 SET 8 

> 8 LET B:=H 

> ' 9 GOSUB 50 

•♦WARNING - NEXT STATEMENT ALREADY EXISTS** 

> 10 SET 20 (RETURN TO ORIGINAL STATEMENT ENTRY 
STATEMENT 10 IS NOT ALTERED) 

> 20 

A typical application would be: 

> 50 GOSUB 900 

> 60 SET 900 

>900 .BEGIN SUBROUTINE 

> 1010 RETURN .END SUBROUTINE 

> 1020 SET 60 

> 60 (RETURN TO ORIGINAL MAIN PROGRAM ENTRIES) 
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3.26 SNPR 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



ALLOWED IN: 
EXAMPLE(S): 



Suppress Non-Error Printout 

SNPR 

Suppress non-error messages* on the Console. The 
RST and ENPR Commands will override SNPR. SNPR 
sets the Reserved Variable NOINPUT to true and 
does not allow INPUT(B) statements to be 
executed. 

NOTE: Default is non-error print enabled. 

Pause Mode Only 

> 110 RUN 
(CONTROL Y) 

Break in Statement MO 

> SNPR 



* These messages are those contained in the PPRINT and PRINT 
statements only. 



.27 SNPS 

OPERATION NAME: Suppress Non-Error Pauses 

MNEMONIC : SNPS 

DESCRIPTION: Suppresses non-error pauses* during AID program 
execution. 

NOTE: Default is non-error pause enabled. 
ALLOWED IN: Pause Mode Only 
EXAMPLE(S): > 110 RUN 

(CONTROL Y) 

Break in Statement 40 

> SNPS 



* These pauses are those found in the PPRINT and PAUSE State- 
ments only. 
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328 TEST 



OPERATION NAME: 
MNEMONIC : 

DESCRIPTION : 



Section Test Select 

TEST [♦ or -] [X[[/Y] ,Z] ] 
TEST ALL 

Allows the operator the capability of externally 
selecting program sections to be executed. The 
optional + or adds or deletes the following 
test sections from the current test section bit 
mask; absence of the ♦ or - deletes all existing 
test section bit masks before continuing. The 
optional slash (/) indicates inclusive sections 
i.e.- 3/5 means test sections 3, 4, 5. The op- 
tional comma ( , ) indicates separate test sec- 
tions (i.e. 1,3.5 means test sections 1 and 3 
and 5)- Section numbers may be entered in any 
order but the section number must be greater 
then and less than 49. Whenever TEST is en- 
tered with parameters the Reserved Variables 
SECTI0NS1/3 are set with bit masks correlating 
to the section numbers (see Reserved Variable 
SECTI0NS1/3) and the Reserved Variable NEWTEST 
is set to true (see Reserved Variable NEWTEST). 
If TEST is entered without parameters the 
NEWTEST Reserved Variable is set to false and 
the bit masks in Reserved Variables SECTI0NS1/3 
are set to all ones. If TEST ALL is entered all 
Test Sections are selected (i.e. All bits in 
SECTI0NS1.SECTI0NS2 and SECTI0NS3 are set). 



ALLOWED IN: 
EXAMPLE(S): 



Pause Mode Only 

> TEST 1/3.5.7,9/11 



TEST 10 



TEST 



TEST 



TEST 



or 
3 

or 

4 
6 



(INDICATES SECTIONS 1,2,3, 
5,7,9,10 AND 11 ARE 
SELECTED) 

(INDICATES SECTION 10 
IS SELECTED) 

(SETS THE NEWTEST RESERVED 
VARIABLE TO FALSE) 

(ADD TEST 4 TO THE TEST 
SECTION BIT MASK) 

(REMOVE TEST 6 FROM THE 
TEST SECTION BIT MASK) 



See the Reserved Variables SECTI0NS1/3 and NEWTEST and the 
statement, SECTION, for further examples and explanations. 



AID 
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AID STATEMENT (NON I/O) I I 1 

I I IV I 



4.0 INTRODUCTION 

The AID statements available to the operator are listed, in de- 
tail here. The format for each statement explanation is: 

OPERATION NAME : General phrase of what the statement does . 

MNEMONIC: The form that the statement would be called in. 

DESCRIPTION: A detailed explanation of the statement's func- 
tion. 



EXAMPLES : 



One or more examples using the statement . 



4.1 ASSIGN 



OPERATION NAME: 
MNEMONIC : 

DESCRIPTION : 



Assign Data to Buffer 

ASSIGN data buffer( element ) [, (repeat factor)], 
datal[,data2] [dataN] 

Stores data into a data buffer. The word datal 
is stored into data buffer (element) and, if in- 
cluded, data2 is stored in data buffer (element 
+1), and so on through dataN, which is stored in 
in data buffer (element+N-1) . If repeat factor 
is included, the data pattern is repeated re- 
peat factor times. Datal through dataN must be 
numeric constants. 



.INITIALIZE AA TO %55 



EXAMPLES : 

> 10 DB AA,100,%55 

> 20 ASSIGN AA(50), 5. 10, 15, 20, 25, 30, 35 
(AA(50)=5, AA(5D = 10, • • ■ AA(56) = 35) 

> 30 ASSIGN AA( 10) ,(10), !FF 

(AA(10) THROUGH AA( 19))= IFF) 

> 40 ASSIGN AA(80) ,(5),3,7 

(AA(80)=3, AA(8l)=7, AA(82)=3, AA( 83)=7 . . . AA( 89) =7 ) 
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> 50 LET A:=80,F:=5 

> 60 ASSIGN AA(A),(F) ,3,7 



.IDENTICAL TO STATEMENT 40 



4 2 BUMP 

OPERATION NAME: Bump Pass Counter 

MNEMONIC: BUMP[;][H] 

DESCRIPTION: Increments the Reserved 
(unless the H parameter is 
that pass count on the Consol 
(Reserved Variable FASSCOUNT 
zero whenever a RUN command 
may be suppressed by a SNPR c 
optional semi-colon follows 
feed will be issued after the 
is printed. The PASSCOUNT 

EXAMPLES(2) : > 10 BUMP H 



Variable PASSCOUNT 
used and then prints 
e. The pass counter 

is initialized to 
is issued. Printing 
ommand and , if the 
BUMP, no return- line 

pass counter value 
is limited to 32767. 



20 RUN 



END OF PASS (N0TE- 



PASSCOUNT is still after 
the print because of the H 
parameter) 



or 

> 10 BUMP; 

> 20 PRINT "FOUND A BUG!!'' 

> 30 RUN 

END OF PASS 1 FOUND A BUG ! ! 

4.3 CB 

OPERATION NAME: Compare Buffers 

MNEMONIC: CB Buffer 1, Buffer 2, Length of Compare 
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DESCRIPTION: Provides a fast comparison between the contents 
of two buffers (two string buffers or two data 
buffers). If the buffer areas compare, the Re- 
served Variable INDEX is set to -1. Otherwise, 
INDEX is set to the element of Buffer 1 which 
did not compare (see INDEX under Reserved Varia- 
bles) . 

The length of the compare is in words ( limit 
32,767) if comparing data buffers, and in bytes 
if comparing string buffers . 



EXAMPLE(S): 




> 5 


CB AA(10), 


BB(10), 10 


> 10 






> 15 


IF INDEX < 


> -1 THEN 20 


> 20 


CB iCC(5), 


ScDD(lO), 6 


> 25 






> 30 


IF INDEX =■ 


-1 THEN 100 


> 35 







COMPARE AA(10)-AA(19> 

WITH BB(10)-BB(19) . 

REPORT ERROR ROUTINE AT 200 

COMPARE BYTES 5-10 OF &CC 

TO BYTES 10-15 OF &DD 

IF INDEX = -1 THEN COMPARE 

WAS GOOD 



NOTE: If a Compare Error occurs in statement 20, you must be 

responsible for remembering that the buffer elements are 
offset (i.e., &CC(5) is compared to &DD(10), not 4DD(5))- 



4.4 . (Comment) 



OPERATION NAME: Comment String 

MNEMONIC: (period) 

DESCRIPTION: Allows entry of comment strings as statements or 
following statements. Any entry following a 
period will be interpreted as a comment string 
for the pending line (the only exception is a 
( ) inside a string) . Comments should be kept 
short and used sparingly since they can only be 
used as source data and thus consume a lot of 
data storage space. 
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EXAHFLE(S): 

> 10 .THIS IS 

> 20 .A COMMENT STRING. 

> 30 GOTO HO .THIS IS A COMMENT STRING 

> HO PRINT "STOP. THEN GO" 

(This does not indicate a comment string) 



4.5 DB 

OPERATION NAME: Define Buffer 

MNEMONIC: DB Name, Length [, assignment data] 

DESCRIPTION: Declares a buffer with a two (alpha) character 
name (AA, BB, . . .ZZ) and a buffer length up to 
allowable space available* (see MAXMEMORY under 
Reserved Variables). The parameter length is 
interpreted as a numeric (0 will delete the buf- 
fer) . The only assignment data allowed at 
declaration is a string assignment for string 
buffers (see example) or numeric or variable for 
data buffer where the entire buffer is stored 
with that numeric or variable. Dynamic 
allocation of buffers is allowed, but may cause 
large overhead in execution time since existing 
buffers are "packed" to allow room for a new 
buffer. Dynamic allocation will leave the 
existing element values unchanged. 



EXAMPLE(S) : 

> 10 DB AA, 100 

> 20 DB &AA, 10 

> 30 DB 4CC.100, 

> 40 DB CC, 100, 

> 50 DB CC, 110 



.DECLARES THE BUFFER AA AS 100 WORDS 
LONG 

.DECLARES THE STRING BUFFER &AA AS 
.10 BYTES LONG (NOTE AA AND &AA 
. ARE SEPARATE BUFFERS ) . 
'START". EACH SEQUENTIAL 5 BYTE SET OF &CC 
.CONTAINS START 



.STORES IN ALL 100 ELEMENTS OF CC. 

.REALLOCATE CC TO 110 WORDS 
(FIRST 100 ELEMENTS INTACT) 
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> 60 DB CC, 



.DELETES BUFFER CC 



"A limit of 32,767 words is set for data buffers, 
length is limited to 32,767. 



String buffer 



46 DELAY 

OPERATION NAME: Delay 

MNEMONIC: DELAY increment 

DESCRIPTION: Provides a delay of program execution in approx- 
imately 91. 13" microsecond increments. The max- 
imum delay increment is 65,535 (5-99 seconds). 



EXAMPLE(S) : 

> 60 DELAY 10 



> 100 DELAY 1 



EXAMPLE(S) : 
> 120 DELAY A 



(SUSPENDS PROGRAM EXECUTION FOR 
914. 3 MICROSECONDS) 

(SUSPENDS PROGRAM EXECUTION 
91.4 MICROSECONDS) 



(SUSPEND FOR Ax91.4 MICROSECONDS) 

Note: Since the Series M0, 44, and 64 have a 
clock cycle of lms, small delays are not 
accurate . 



4.7 ENABLE 



OPERATION NAME: Enable Errors 
MNEMONIC : ENABLE 



DESCRIPTION: 



EXAMPLE(S) : 



Re-enables program execution error reporting 
previously disabled by a SUPPRESS statement or 
the commands SEPR and SEPS. 



100 ENABLE 



(SUBSEQUENT ERRORS WILL NOW BE 
REPORTED DURING EXECUTION) 
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4.8 END 

OPERATION NAME: 

MNEMONIC : 
DESCRIPTION: 

EXAMPLE(S): 



Stop Program 

END 

Indicates the end of the existing program execu- 
tion. END may be used anywhere in the program 
and does not have to be the last statement. 

> 10 LET A: =4 

> 20 PRINT A 

The above program is identical in execution to: 

> 10 LET A: =4 

> 20 PRINT A 

> 30 END 



END may be used anywhere to terminate program 

> 5 LET A: -4 

> 10 GOSUB 30 

> 20 END 

> 30 LET A:=A ♦ 1 

> 40 PRINT A 

> 50 RETURN 



4.9 EPA USE 

OPERATION NAME: Error Pause 

MNEMONIC : EPAUSE 

DESCRIPTION: Creates an unconditional pause in the execution 
of the resident program. This statement is sup- 
pressed only by the SEPS command and SUPPRESS 
statement. A prompt character (>) is printed on 
the console; the operator may enter any valid 
command . 
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EXAMPLE: 



> 20 RUN 

> (Any valid command maybe entered) 



4.10 EPRINT 

OPERATION NAME: Print Error Message to Console 

MNEMONIC: EPRINT [*] [string [,(or;)] [string] etc.] 



DESCRIPTION: 



Enables data, print spacing*, or strings to be 
output to the Console. This statement must be 
used to print error messages only (see PRINT for 
non-error messages). This statement will only 
be suppressed the SEPR command and SUPPRESS 
statement. The optional (*) disables the pause 
following the print. If the Reserved Variable 
STEP is greater than zero, the error message is 
preceded by a STEP number message (See Reserved 
Variable STEP) . 



EXAMPLE(S) : 

> 10 EPRINT &BB(0,7) . &BB PREVIOUSLY SET TO "BAD UNIT" 

> 20 EPRINT * &BB(0,7) 

> 30 RUN 



BAD UNIT 
> GO 
BAD UNIT 



CREATED BY STATEMENT 10 



CREATED BY STATEMENT 20 



END OF AID USER PROGRAM 

--or — 

> 10 EPRINT "DATA WORD ";A; "IS"; !BB(J);" SHOULD BE 

> 20 RUN 

DATA WORD 5 IS 1F8DH SHOULD BE !F7D4 



!CC(J) 



# See Print Spacing under Special Characters . 
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4.11 FILENAME 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



Set Filename 

FILENAME string buffer [.offset] 

Specifies the filename* pointed to by the string 
buffer parameter be used in future file access 
statements. The. optional offset (always for 
DUS tape) is the sector number (for DUS disc) 
from the start of the file, to start subsequent 
file accesses from (default is 0). The string 
pointed to in this statement must contain a 
valid and existent filename during execution and 
must terminate in a space character. Also see 
the CREATE command, The READFILE and WRITE-FILE 
statements, and FILEINFO and FILELEN reserved 
variables . 



EXAMFLE(S) : 

> 10 DB &AA,9,"FNAME123 " 

> 20 FILENAME iAA(O) 

(ALL FUTURE FILE REFERENCES WILL ACCESS THE FILE 

NAMED FNAME123) 



100 PILENAME &AA(2) ,5 

(ALL FUTURE FILE REFERENCES WILL ACCESS THE FILE 

NAME AME123 STARTING FROM THE 6TH SECTOR 
I.E. -SECTOR 5 OF THE FILE) 



The file "filename" must reside on the Diagnostic/Utility 
Media being used and must be a valid filename as specified 
by the Diagnostic/Utility System Reference Manual. 



4.12 FOR-STEP-UNTIL 



OPERATION NAME: 
MNEMONIC : 



For-Step-Until 

F[0R] assignment exp [STEP exp] UNTIL(or TO) 
terminator exp 
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DESCRIPTION: Provides a means of repeating a group of in- 
structions between the FOR statement and a sub- 
sequent statement using a variable as a counter. 
The variable cannot be a string buffer element. 
The STEP parameter is an optional increment of 
the FOR variable with a default of 1. The FOR- 
NEXT sequence is repeated until the terminator 
expression value is exceeded* by the FOR vari- 
able value. FOR statements may be nested. Note 
that no execution occurs in the FOR statement 
fefter the initial execution. Note also that 
UNTIL or TO may precede the terminator expres- 
sion, but UNTIL will always be listed. 



EXAMPLE(S): 

> 10 FOR I: = 5 to 50 



> 100 NEXT 10 



.WILL EXECUTE THE STATEMENTS 
.BETWEEN 10 AND 100 («6 TIMES) 
.WITH 1*5 THRU 1=50 STEPPING 
.ONE AT A TIME 



> 10 FOR I:«5 STEP 8 UNTIL 50 

.WILL EXECUTE THE STATEMENTS 

.BETWEEN 10 AND 100 (6 TIMES) 
.WITH 1=5. 13, 21, 29, 37, «5 

> 100 NEXT 10 



> 10 FOR I:-5 STEP B:-8 UNTIL C:=50 

.THIS SEQUENCE PROVIDES 

.THE SAME SEQUENCE OF 
.STATEMENTS AS ABOVE 

> 100 NEXT 10 



> 10 FOR AA(2):= -5 TO 50 

(AA(2) WILL STEP -5, -4,-3 , -2, -1,0,1 ... 50) 

> 100 NEXT 10 



•If the STEP value is negative the sequence will repeat until the 
FOR value is less then the UNTIL value. (Note: The FOR loop 
always executes at least once.) 
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4.13 GOSUB 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



Go to Subroutine 

G[OSUB] Statement 

Allows program to enter a subroutine and then 
return to the next sequential statement* after 
GOSUB statement. Nesting subroutines is allowed 
to 20 levels. 



EXAMPLE(S): > 10 GOSUB 500 
> 20 ... 



.GO TO THE SUBROUTINE STARTING 
.AT STATEMENT 500. 



> H90 GOTO 600 .JUMP AROUND THE SUBROUTINE. 

> 500 LET A:-A*l .THIS SUBROUTINE 

> 510 PRINT A; .WILL INCREMENT A 

> 520 RETURN .PRINT IT ON THE CONSOLE AND THEN 

.RETURN CONTROL TO THE STATEMENT 
.FOLLOWING THE GOSUB WHICH CAUSED 
.TRANSFER OF CONTROL TO 500. 

•See Reserved Variable OFFSET for returning to other statements. 



4.14 GOTO 

OPERATION NAME: GO TO (Unconditional Branch) 
MNEMONIC: GOTO Statement Number 



DESCRIPTION: 
EXAMPLE( S) : 



Allows the program to branch unconditionally to 
another statement number. 



> 10 GOTO 50 



.TRANSFER CONTROL TO STATEMENT 50 
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OPERATION NAME: If -Then Control 



MNEMONIC : 
DESCRIPTION: 



IP exp [[SPECIAL OPERATOR exp] [SPECIAL OPERATOR 
exp]] THEN statement number 

Allows the executing program to evaluate "exp" 
and, if true (non-zero)*, to transfer control to 
statement number specified. "Exp" may be a sim- 
ple variable, data buffer element, assignment or 
expression. Expressions may be separated by a 
special relational operator not allowed in any 
other expression. The allowable special opera- 
tors are: 



GT 
LT 
GE 
LE 
NE 
EQ 



(greater than) 

(less than) 

(greater than or equal to) 

(less than or equal to) 

(not equal to) 

(equal to) 

I WARNING I 



String buffers are handled as data buffers in 
this mode, i.e., &AA(0):-5 would store &AA(1) 
with 5- 

Each expression is evaluated and then tested 
(left to right) with the special operator. The 
results of the special operator evaluation(s) is 
logically ANDed and if the overall result is 
true, control is transferred to the THEN state- 
ment. Up to three expressions are allowed. 
EXAMPLE(S) : 

> 10 IF AA(2) THEN 50 .IF AA(2) IS TRUE (NON-ZERO) GO 
TO 50 

> 50 IF B:-C THEN 30 .THE ASSIGNMENT IS EXECUTED THEN 
.EVALUATED. 

> 70 IF A OR B THEN 30 .THE EXPRESSION "A OR B" IS 
.EVALUATED. 

> 80 IF 1« LE A:=A+1 LE 20 THEN 120 

.TEST IF A+l IS BETWEEN It AND 

20 INCLUSIVE. 

> 90 IF A:=A+1 GE B:=B+1 GE C:=C+1 THEN 200 

.TEST IF (Afl)>«(B+l)>»(C+l) 



>100 IF 1 LT B LT 100 THEN 20 

.TEST IF B IS BETWEEN 1 & 



100" 



14-11 



AID Diagnostic Language 



* See IFN Statement for the reverse branch condition. 

"Note that statement 100 would not execute the same as IF 
1<B<100 THEN 20 which executes as "IP(1<B)<100 THEN 20" where 
the result of 1<B will equal -1 or 0. 



4J« IFN-THEN 



OPERATION NAME: 

MNEMONIC: 

DESCRIPTION: 



EXAMPLE(S) 
> 10 



IF-NOT-THEN 

IFN exp THEN statement 

Identical to the IF-THEN statement (see IF-THEN) 
except the expression "exp" is tested for fal- 
sity in determining if control is passed to the 
label "statement". The expression value is not 
altered by the NOT function. 



IF 1 LE A LE 11 THEN 20 

.IF A IS BETWEEN 1 AND It GOTO 20 

> 20 IFN 1 LE A LE 14 THEN 20 

.IF A IS "NOT" BETWEEN 1 AND 14 

GOTO 20 





— or-- 




> 10 


IF A THEN 20 


.IF A<>0 GOTO 20 


> 20 


IFN A THEN 20 


.IF A-0 GOTO 20 



*J7 INPUT 



OPERATION NAME: 
MNEMONIC : 

DESCRIPTION: 



Input Data 

INPUT x,[y],...[n] 
I x,[y],..[n] 

Provides capability of receiving operator input 
from the Console and assigning that input to a 
variable(s). x may be a simple variable, buffer 
element, string buffer or Reserved Variable. 
When executing, input prompts with a ? or ?? to 
signify an input is expected (see Special Char- 
acters). Each input value must be separated by a 
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EXAMPLE(S) : 

10 INPUT A 



comma. Inputs may be an ASCII character but not 
! or % alone. Also change in character type will 
terminate input but not necessarily report an 
error. Additional input beyond the expected is 
ignored. All ASCII characters are shifted to 
upper case. See Reserved Variable INPUTLEN for 
determining the character length of the input . 



.VALUE INPUT FROM THE CONSOLE IS 
.INTERPRETED AND THEN STORED 
.IN A 



30 



HO 



INPUT AA(2) 
INPUT &BB(2,6) 



50 INPUT A,B,C 

60 INPUT A 

70 RUN 
?' J7776 
? !F1 
? HELLO 
? 2,U 
?? 8 
? B 



.AA(2) WILL BE STORED WITH THE 
.INPUT VALUE. 

.ELEMENTS 2 THROUGH 6 OF STRING BUFFER 
.&BB WILL READ THE FIRST 5 CHARS INPUT 
.FROM THE CONSOLE. STRING BUFFERS MUST 
.BE USED IF ASCII INPUT IS REQUIRED. 

.THE OPERATOR MUST INPUT THREE 
.NUMERIC VALUES (SEPARATED BY COMMA 
.DELIMITERS) TO BE ASSIGNED TO A, 
.B AND C 



(STATEMENT 10 EXECUTION A:=%7776) 

(STATEMENT 30 EXECUTION AA(2):«!F«) 

(STATEMENT «0 EXECUTION &BB(2.6):» 

"HELLO") 

(STATEMENT 50 EXECUTION A: -2, B:»H) 

(STATEMENT 50 MORE INPUT REQUIRED 
C:»8) 

(STATEMENT 60 EXECUTION A:-*102) 
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4.18 INPUTS 

OPERATION NAME: Input for buffers 

MNEMONIC: INPUTB XX(N) 

DESCRIPTION: This statement allows variable length numeric 
input into a buffer. XX(N) is the first buffer 
element. Commas may replace data to suppress in- 
put into that element. String buffers are not 
allowed . 

EXAMPLE(S): 

10 DB XX. 7, 9 .Fill XX with nines 

20 POR I:«0 UNTIL 6 .Print initial XX contents 

30 PRINT XX(I);1; 

40 NEXT 20 

15 PRINT 

50 INPUTB XX(0) 

60 POR I:«0 UNTIL 6 

70 PRINT XX(I);1; 

80 NEXT 60 

90 RUN 

9 9 9 9 9 9 9 
1 ,.2.3, .5 
9 9 2 3 9 5 9 

Note that XX(0). XX(1), XX(«) and XX(6) are not changed by the 
input . 



.Get input data from operator 

.Print XX contents with input 
values 
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OPERATION NAME: Assignment 

MNEMONIC. [LET] variable := Any variable, numeric, expres- 
sion or string 

DESCRIPTION: Allows assignment to a variable, data buffer or 
string buffer, the value of any variable, numer- 
ic, expression, or string. 

EXAMPLE(S) : 

> 10 LET A:=10 

> 20 LET C:=D+E 

> 30 LET AA(2):=!F 

> 45 LET A:=C:=« 

> 48 LET A:=4,B:=7 

> 50 LET AA(4) :=B 



.A IS ASSIGNED THE VALUE DECIMAL 10. 

.C IS ASSIGNED THE SUM OF D+E. 

.ELEMENT 2. OF THE BUFFER AA IS ASSIGNED 
.THE HEXADECIMAL VALUE F. 

.MULTIPLE VARIABLE ASSIGNMENTS ALLOWED. 

.MULTIPLE EXPRESSION ASSIGNMENTS 
ALLOWED . 

.ELEMENT 4 OF BUFFER AA IS ASSIGNED 
.THE VALUE OF THE B VARIABLE. 



> 60 LET &AA(5.9):="HELLO" 

.4AA(5,6)=HE, 4AA(7,8)=LL, &AA(9)=0 

> 70 A: =10 .IDENTICAL TO STATEMENT 10* 



> 80 LET A:=B<C 



.A=-l if B<C else A=0 



"The LET keyword may be omitted but a subsequent list will 
display it. 
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4.20 LOOPTO 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

EXAMPLE(S): 



Conditional Loop Branch 

LOOPTO label 

Causes a branch to the statement specified in 
label if a LOOP Command was previously issued 
otherwise no action occurs. 

> 100 SECTION 1,200 

> 200 SECTION 2,500 

> 500 LOOPTO 100 .Go to 100 if LOOP flag is 
set. 



4il LPOFF/LPON 

OPERATION NAME: Control offline listing 

MNEMONIC : LPOFF/LPON 

DESCRIPTION: Print statements normally have their output di- 
rected to the Console. LPON statements may be 
used to direct the print output to the line 
printer* . LPOFF will direct the output back to 
the console. 

EXAMPLE(S): > 10 PRINT "This will go to the Console" 

> 20 LPON 

> 30 PRINT "This will go to the line printer" 

> 40 LPOFF 

> 50 PRINT "This will also go to the Console" 

> 60 RUN 

• If no line printer exists the print will default back to the 
console. 
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A2.Z NEXT 
OPERATION NAME: 
MNEMONIC : 

DESCRIPTION: 
EXAMPLE(S): 



End of Por-Next loop 

NEXT x 
N x 

Specifies the end of a For-Next set of state- 
ments where x must be the statement number of a 
respective FOR statement. 

> 10 LET J:-5 

> 20 FOR K:»l UNTIL 20 

> 30 LET BB(K):«J, J:«J*5 

> 40 NEXT 20 



4.23 NOCHECKS 



This set of statements would store BB(1)«5, 
BB(2)-10, . . .BB(20)*100. 



OPERATION NAME: No Checks Enabled 

MNEMONIC : NOCHECKS 

DESCRIPTION: Gives the programmer the ability to disable time 
critical execution error checks*. This statement 
would typically be the first statement in a 
"finished known good" program so that the execu- 
tion overhead of programming checks is allevi- 
ated (i.e., bounds violations, uninitialized DB, 
etc. need not be checked). The "checks" condi- 
tion is always enabled until this statement is 
encountered and then no checks are done until 
execution is completed. 

EXAHPLE(S): 

> 10 NOCHECKS 

> 20 DB AA.100 

> 30 LET BB(100) :=12 



(Buffer area overflow not checked) 



(Bounds and buffer declarations 
not checked) 

• If a catastrophic error occurs in the "no checks" mode 
the results are unpredictable. 
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*2* PACE 



OPERATION NAME: Page Eject 



MNEMONIC : 
DESCRIPTION: 

EXAMFLE(S): 



PAGE 

Issues a page eject to the printer device during 
Listing. During execution this statement exe- 
cutes as a comment. 



100 
110 
120 
130 



.END OP SECTION X 

PAGE 

.BEGIN SECTION Y 

L PRINTER 100/120 



(Listing of Line Printer looks like the 
following) . 

100 .END OP SECTION X 



(Page Eject) 

120 .BEGIN SECTION Y 



*25 PAUSE 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 



Non-Error Pause 



PAUSE 



Creates an unconditional pause in the execution 
of an AID user program. This statement is sup- 
pressed only by the SNPS command . After a 
prompt (>) is printed on the console the opera- 
tor may enter any valid command . 



EXAMPLE(S): > 10 PAUSE 

> 20 RUN 

> (Enter any valid command) 
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4.26 PCN 

OPERATION NAME: Push Computer Number 

MNEMONIC: PCN XX(N) 
PCN X 



DESCRIPTION: 
EXAMPLE: 



This statement executes the PCN instruction. 
The 16 bit number is placed in X or XX(N) . 

> 10 PCN A 

> 20 PRINT A; "is number for Series 6JI" 

> 30 RUN 



U is number for Series 64 



4JT PPR1NT 

OPERATION NAME: Pause Print 

MNEMONIC: PPfRINT] [•] string [; (or ,)] [string] (etc.) 

DESCRIPTION: PPRINT is identical to the PRINT statement ex- 
cept after the print a pause occurs. PPRINT may 
be suppressed by SNFR and pause may be sup- 
pressed by SNPS. The optional (*) will suppress 
pause which follows print. If the Reserved Vari- 
able STEP is greater than zero the message 
string is preceded by a STEP number message (See 
Reserved Variable STEP). 

EXAMPLE(S): > 10 LETA:=5 

> 20 PPRINT "BAD GUY IN" ;2;A 

> 30 RUN 
BAD GUY IN 5 

> (pause mode) 
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-or- 

> 10 PPRINT • "TOO LATE NOW!!' 

> 20 RON 

TOO LATE NOW! ! 

END OP AID USER PROGRAM 

> 20 



.SUPPRESS PAUSE 



428 PRINT 

OPERATION NAME: Print to Console without Pause 

MNEMONIC: PR[INT] [string] [; (or .)] [string] etc. 

DESCRIPTION: Enables data, print spacing' or strings to be 
output to list device. This statement must be 
used to print non-error messages only (see 
EPRINT or PRINTEX for error message reporting). 
This PRINT will only be suppressed by the SNPR 
command. PRINT strings may be concatenated with 
( ; ) to suppress return line feed or ( , ) which 
generates a return linefeed. 

EXAMPLE(S): > 10 PRINT "A" ; 2 ; "BC" , "DE" ; 3 ; "FGH" 

> 20 RUN 
A BC 

DE FGH 

-or- 

> 10 DB &AA,10,"ABCDEFG" 

> 20 PRINT 4AA(3.6);2;iAA(0,2) 

> 30 RUN 
DEFG ABC 

> 30 



* See PRINT SPACING under Special Characters. 
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*29 PRINTEX 

OPERATION NAME: 
MNEMONIC: 
DESCRIPTION : 

EXAHFLE(S): 



Print Error without Pause 

PRINTEX [string] [; (or ,)] [string] etc. 

PRINTEX is identical to PRINT except that it is 
suppressed by SEPR like EPRINT (see PRINT for 
further details). 

> 10 PRINTEX "ABC";"DEF";2;"GHI" 

> 20 RUN 
ABCDEF GHI 

> 20 



4.30 RANDOM 

OPERATION NAME: Generate Random Numbers 



MNEMONIC : 
DESCRIPTION : 



EXAMPLE(S): 



RANDOM [(argument)] variablel [,variableN] 

Generates random integers (-37,768 to 32,767) 
from an argument (optional) and stores them into 
variables specified (variablel to variableN) . If 
an arguement is not included the random sequence 
continues normally, otherwise the random gener- 
ator is preset to the argument . The random 
generator will cycle through 128,563 random 
numbers . 



> 10 RANDOM(10)A,B 

> 20 RANDOM(10)C.D 

-or- 

> 10 RANDOM A 



(NOTE THAT A=C AND B=D SINCE 
THE SAME ARGUMENT WAS USED) 



NO ARGUMENT 



> 10 RANDOM(RUNPARAMl) A (OPERATOR PASSED AN ARGUMENT 
WITH RUN X) 



> 10 RANDOM AA(0),F, TIMEOUT 

(GENERATE THREE SEQUENTIAL 

RANDOM NUMBERS WITH NO 
INITIAL ARGUMENT) 
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4JI READCLOCK 

OPERATION NAME: Read System Clock Contents 
MNEMONIC: READCLOCK variable 



DESCRIPTION : 



EXAMPLE(S): 



Reads the contents of a register which contains 
the amount of clock intervals as specified in 
STARTCLOCK statement (see STARTCLOCK Statement). 
Resolution is restricted to +-95% of a clock in- 
terval, therefore, averaging schemes should be 
used for critical timing measurement. This 
statement also stops the system clock from fur- 
ther interrupts . 



> 100 STARTCLOCK 10 

> 110 RSIO AA 

> 120 READCLOCK A 



.START 10 MILLISECOND 

TIMER 
.START CHANNEL PROGRAM 
.GET 10 MILLISECOND 

INTERVAL COUNTER VALUE 
SINCE STATEMENT 100 



NOTE: The amount of overhead in executing 
AID statements should be accounted 
for by the programmer. 



4J2 READFILE 

OPERATION NAME: Read Pile 

MNEMONIC: READFILE buffer element , length 

DESCRIPTION: Reads data from the file "filename"* and stores 
it into memory starting at the location of the 
buffer element for length words (or characters if 
using a string buffer)*". Any file may be ac- 
cessed by this statement. 
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EXAMPLE? S): 



> 10 DB &AA, 7. "HOLDIT " 

> 15 DB BB.10 

> 20 FILENAME &AA(0) 



> 30 READFILE BB(0),10 (The first 10 words of the file 
HOLDIT are stored into the buf- 
fer BB starting at element 
zero) 

* A valid FILENAME statement must be executed prior to executing 
this statement . 

**If the buffer being written is a string buffer the element is 
rounded down to the nearest even element to maintain even word 
boundaries. If a "rounding" is needed the length parameter is 
incremented. 



Example: > 100 READFILE &AA(3).5 



This statement would read 6 bytes from HOLDIT and put them into 
&AA(2). 



4.33 RETURN 

OPERATION NAME: Return from Subroutine 



MNEMONIC : 
DESCRIPTION : 

EXAMPLE(S): 



RtETURN] 

Causes a transfer of control to the next sequen- 
tial statement after the last GOSUB statement 
executed.* If no GOSUB occurred, program execu- 
tion is aborted with an error message. 



10 GOSUB 60 
20 . . . 



.GO TO SUBROUTINE STARTING AT 
60. 



60 LET A:=A+1,B:=B+1 

70 RETURN .RETURNS TO STATEMENT 20 

'See Reserved Variable OFFSET for returns to other statements . 
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434 SECTION 



OPERATION NAME: Section Execute Test 



MNEMONIC : : 
DESCRIPTION: 



EXAMPLE(S) 



SECTION x, label 

When a program is split up into sections the 
SECTION statement* may be used to determine 
whether to execute a particular section. The 
executable sections are predefined by the TEST 
command and/or by assigning values to the 
Reserved Variable SECTI0NS1/3 (see Reserved Var- 
iable section for further details). When a SEC- 
TION statement is executed the Section x bit is 
extracted from the appropriate bit mask for 
SECTI0NS1/3 and if set the next sequential 
statements are executed normally and the 
Reserved Variable SECTION is set to the section 
number. Otherwise, control is transferred to 
the statement specified in LABEL. 

> 10 SECTION 1. 60 

> 20 

> 50 .End of section 1 

> 60 SECTION 2, 120 

> 70 



> 120 . END OF SECTION 2 



Do NOT confuse the SECTION statement with the SECTION 
Reserved Variable. 
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4J5 SPACE 



OPERATION NAME: Line Space 

MNEMONIC: SPACE {X] 

DESCRIPTION: When listing a program on a printer device, gen- 
erates X line spaces before the next statement . 
During execution this statement is treated as a 
comment. Default X is 1 space. 

EXAMFLE(S): > 10 .END OF STEP X 

> 20 SPACE 3 

> 30 .BEGIN STEP Y 

> U0 LIST PRINTER 



( listing on the line printer looks like the 
following) 



10 



.END OF STEP X 



(3 Line Spaces) 
30 .BEGIN STEP Y 



*Jt SPACESOFF/SPACESON 

OPERATION NAME: Control Numeric Print (with/without leading 
spaces) 

MNEMONIC : SPACESOFF/SPACESON 

DESCRIPTION: Allows the programmer to print numbers right 
justified with leading spaces (SPACES0N) . The 
default condition is no leading spaces until a 
SPACES0N is executed. SPACESOFF disables leading 
spaces print . 

Note: Hex number occupy 5 digits 

Octal numbers occupy 7 digits 

Decimal numbers occupy 6 digits 
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EXAMPLE(S): 



> 10 LET A:«!FDF.B:»%7657.C:-«839 



.LEFT JUSTIFIED 

.RIGHT JUSTIFIED 
.RETURN TO LEFT JUSTIFIED 



Note 



> 20 PRINT !A;*B;C 

> 30 SPACESON 

> 40 PRINT !A;*B;C 

> 50 SPACESOFF 

> 60 RUN 

!FDFX7657«839 
!FDF S7657 «839 

ir ZER0ES0N and SPACESON are both enabled then ZEROESON is 
dominant 



4.37 STAHTCLOCK 

OPERATION NAME: Start System Clock 

MNEMONIC: STARTCLOCK [interval in milliseconds] 



DESCRIPTION: 



example; s) 



Initiates operation of the system clock and cau- 
ses a counter increment every interval as speci- 
fied in the optional parameter. (Default is 1 
millisecond.) The clock's resolution is *-95% 
of the interval specified. 



>100 STARTCLOCK 



.START 1 MILLISECOND TIMER 



> 100 STARTCLOCK 1 .START 1 MILLISECOND TIMER 
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4.3S SUPPRESS 

OPERATION NAME: Suppress Errors 

MNEMONIC : SUPPRESS 

DESCRIPTION: Resets the ENABLE statement override flag thus 
returning to conditions set by the error print- 
ing commands . See ENABLE statement . 



4.39 WRITEFILE 

OPERATION NAME: Write Pile 

MNEMONIC: WRITEFILE buffer element, length 

DESCRIPTION: Writes data starting at the element of the spec- 
ified buffer into the file "filename • for 
length words (or characters if using a string 
buffer)**. Only DATA and SPLII files may be 
written into by this statement. (See the Diag- 
nostic/Utility System manual for further infor- 
mation. ) 

EXAMPLE(S): > 10 DB J.AA.6 , "HOLD1 " 

> 15 DB BB.200 

> 20 FILENAME &AA(0) 

> 30 WRITEFILE BB(100),20 

(Writes data starting at BB(100) 

into the file H0LD1 for 20 words) 

• A valid FILENAME statement must be executed prior to executing 
this statement . 

••If the buffer being written is a string buffer the element is 
rounded down to the nearest even element to maintain even word 
boundaries. If "rounding" is needed the length parameter is 
incremented . 

Example: > 100 WRITEFILE &AA(3).5 
This statement would write 6 bytes into H0LD1 starting at &AA(2). 
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4M ZEROESOFF/ZEROESON 



OPERATION NAME: Control Numeric Print (with/without leading 
zeros ) 

MNEMONIC : ZEROESOFF/ZEROESON 

DESCRIPTION: Allows the programmer to print numbers right 
justified with leading zeroes (ZEROESON). The 
default condition is no leading zeroes until a 
ZEROESON is executed. ZEROESOFF disables leading 
zeroes print. 

Note: Hex numbers occupy 5 digits 

Octal numbers occupy 7 digits 

Decimal numbers occupy 6 digits 

EXAMPLE(S): > 10 LET A:«!FDF,B:-*7657.C:-1|839 

> 20 PRINT !A;»B;C .LEFT JUSTIFIED 

> 30 ZEROESON 

> 40 PRINT iA;JSB;C 

> 50 ZEROESOFF 

> 60 RUN 



.RIGHT JUSTIFIED 

.RETURN TO LEFT JUSTIFIED 



Note: 



!FDF*7657M839 
1OFDFXO0765700U839 

If ZEROESON and SPACES0N are both enabled then ZEROESON 
is dominant. 
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5.0 INTRODUCTION 

The AID Special Characters are listed, in detail, in this sec- 
tion. The format for each Special Character explanation is: 

OPERATION NAME: General phrase of what the Character does. 

SYMBOL: The Special Character. 

DESCRIPTION: 



EXAMPLE(S): 



A detailed explanation of the Special Charac- 
ter's function. 

One or more examples using the Special Character 



SI PERIOD 

OPERATION NAME: 
SYMBOL: 
DESCRIPTION : 



Comment Identifier 
(Period) 

See the description under Comment in the State- 
ment Section. 



52 CONTROL H 

OPERATION NAME: Backspace (one character) 

SYMBOL: CNTRL H (Bs) or BACKSPACE 

DESCRIPTION: Allows the operator to backspace to the last 
character entered by pressing the CNTRL and H 
keys simultaneously on the console. The cursor 
is relocated to the last character input and 
that character is deleted. 

EXAHPLE(S): CRT Example 



i 10 LES 

(S is incorrect. Operator presses CONTROL H) 
> 10 LE 
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S.3 CONTROL X 

OPERATION NAME: Delete Existing Line Input 

SYMBOL: CNTRL X(CN) or DELETE ENTRY 

DESCRIPTION: Allows the operator to delete the existing input 
character string by pressing Control and X si- 
multaneously on the Console. Three exclamation 
marks (!!!) and a return- line feed are printed* 
and the operator may input a new string of char- 
acters. 

EXAMPLE(S): > 10 LET Xc ! ! ! (No input occurs) 



?6,7Xc!!l (Deletes all inputs) 



* Note- ! ! ! may not be displayed on some Console types . 



5.4 PARENTHESES 

OPERATION NAME: 

SYMBOL: 

DESCRIPTION: 



Enclose 

( ) Parentheses 

Used to: 

— Enclose a buffer element 

--Enclose a special optional parameter 



EXAMPLE(S): 

> 10 LET AA(2):-2 

> 20 LET 4BB(2):-"H" 

> 30 PRINT "(2)" 

> 40 RANDOM(X) A 



.DEFINES ELEMENT 2 OP AA 

.DEFINES BYTE 2 OF IBB 

.PARENTHESES ARE ASCII CHARACTERS ONLY 

.ENCLOSES OPTIONAL ARGUMENT 
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55 QUOTATION MARKS 

OPERATION NAME: Enclose a Character String 

SYMBOL: " " (Quotation Marks) 

DESCRIPTION: Encloses a string of characters for assignment 
or printing.* 

EXAMPLE(S): 

> 10 LET &AA(1):="H" (SET THE RIGHT BYTE 

OF WORD 1 OF &AA TO AN ASCII 

CHARACTER 4) 

> 20 LET &CC(10,1«):="HELLO" 

(STARTING AT CHARACTER 10 

OF &CC STORE THE ASCII 
CHARACTERS HELLO SEQUENTIALLY) 

> 30 PRINT "OK" .PRINTS OK ON THE CONSOLE. 
•Note: Quotation marks inside a string are not allowed. 



5.6 EXCLAMATION MARK 

OPERATION NAME: Hexadecimal Notation 



SYMBOL: 
DESCRIPTION: 

EXAMPLE(S): 

> 10 PRINT !G 

> 20 PRINT "!A" 

> 30 LET A:=!F 



! (Exclamation Mark} 

Denotes the following variable, numeric or buf- 
fer element will be referenced or manipulated as 
a hexadecimal based number. 



.PRINT THE VALUE OF G IN HEXADECIMAL. 
.DENOTES AN ASCII !A ONLY. 
. A-HEXADECIMAL F 
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S.7 PER CENT SIGN 

OPERATION NAME: 
SYMBOL: 
DESCRIPTION : 

EXAMPLE(S): 



Octal Notation 

% (Per Cent Sign) 

If the symbol (%) is not contained in a charac- 
ter string, it denotes the variable, numeric, or 
buffer element following it is represented or 
manipulated as an octal based number. 

> 10 PRINT %G .PRINT THE VALUE OF G IN OCTAL 

> 20 PRINT "XA" .DENOTES AN ASCII STRING *A 

> 30 LET A:»*37 .A=0CTAL 37 



SX PRINT SPACING 

OPERATION NAME: 

SYMBOL: 

DESCRIPTION: 



Print Spacing 

through 79 

Provides print spacing when concatenating 
strings in print statements. 



EXAMPLE(S): 

> 10 PRINT 8; "EIGHT" 



.PRINTS 8 SPACES AND THEN "EIGHT" 



> 20 PRINT "BIG"; 15; "GAP" 

.PRINTS BIG, 15 SPACES AND THEN 

.GAP 
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SS GREATER THAN SIGN 

OPERATION NAME: Prompt Character 
SYMBOL: > (Greater Than Sign) 



DESCRIPTION : 



EXAMPLE(S): 



When AID or an executing program expects a Con- 
sole input, the prompt (>) is printed in the 
first line space (See the operators section for 
a description of the "greater than" function) . 

> 100 RUN 



(CONTROL Y) 

Break in Statement 50 

> (AID IS NOW AWAITING OPERATOR INPUT) 



5.10 AMPERSAND 



OPERATION NAME: String Buffer Designtion 

SYMBOL: & (Ampersand) 

DESCRIPTION: Denotes a string buffer. This Special Character 
is not allowed anywhere else (except inside a 
character string) . 



EXAMPLE(S): 



> 10 DB &AA.10 .DEFINES &AA AS A 10 CHARACTER STRING 
BUFFER 

> 20 INPUT SAA(2.l4) .ACCEPTS 3 ASCII CHARACTERS 



> 30 LET &A:="HI" 

> UO LET &AA:="HI" 



.NOT ALLOWED. VARIABLES CANNOT BE 
USED 

(NOT ALLOWED. STRING LENGTH 
MUST EQUAL ELEMENT COUNT) 

> H5 LET &AA(0,1):="HI" (ALLOWED. ELEMENT COUNT 

EQUALS STRING LENGTH) 

> 50 PRINT "i";A .SPECIFIES AN ASCII 4 WILL BE PRINTED 
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S.11 ; (SEMI-COLON) 

OPERATION NAME: Suppress Return-Line Feed 

SYMBOL: ; (semi-colon) 

DESCRIPTION: If the symbol ( ; ) is contained in a concatenated 
print string, it denotes no return-line feed is 
desired after the print operation. A comma is 
used to force a return-line feed { see comma 
Special Character) . 

EXAMPLE(S): > 5 LET A:*5 

> 10 PRINT A; 

> 20 PRINT A;" DAYS" 

> 30 PRINT "CALL " ;A 

> «0 PRINT ";" 

> 50 PRINT A;5;A;U;A,A;5;A 

> 60 RUN 

The results of the above statements are as follows : 

55 DAYS (statement 10 and 20) 

CALL 5 (statement 30) 

; (statement 10) 

5 5 5 (statement 50) 

5 5 



5.12 CONTROL Y 

OPERATION NAME: Suspend Execution 

SYMBOL: Control Y(Em) 

DESCRIPTION: During execution of a program or command, the 
operator may interrupt and suspend execution by 
pressing control and Y simultaneously. The 
prompt(>) is printed to indicate AID is awaiting 
operator input. 
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AID Diagnostic Language 



> 100 RUN 



(The AID program is now executing.) 

CTRL Y (Operator presses Control and Y) 

Break in Statement 20 



5.13 ?or?7 
OPERATION NAME: 
SYMBOL: 
DESCRIPTION: 



EXAMPLE(S) 



Input Expected 

? or ?? 

A question mark (?) indicates the executing 
program expects an operator input. A double 
question mark (??) indicates the operator did 
not input sufficient information (i.e. more 
input is expected). 



> 10 

> 20 

> 30 

> 40 
INPUT 
"7,1 
?? 8 

3 6 8 



PRINT "INPUT" 
INPUT A,B,C 
PRINT A;2;B;2;C 
RUN 
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SI* COMMA 



OPERATION NAME: Separation of Expressions or Force Return-Line 
Peed 



SYMBOL: 
DESCRIPTION: 



(C 



Comma (,) may be used to separate expressions; 
to force a return- linefeed in concatenated print 
strings (see semi-colon Special Character for 
suppressing return-line feed); during command 
and statement input to separate parameters , and 
during INPUT execution to delimit individual 
inputs. 



EXAMPLE(S): 

> 10 LET A:«4. B:»5 

> 20 PRINT A,B 

> 30 PRINT "," 

> 40 RUN 



.COMMA SEPARATES EXPRESSIONS 
.FORCE RETURN-LINE FEED 
.DESIGNATES AN ASCII COMMA ONLY 



> 10 RUN 1,2,3 



(COMMAS SEPARATE RUN PARAMETERS) 



-or- 

> 10 INPUT A.B.C 

> 20 RUN 
? 1,2.3 



(COMMAS SEPARATE INPUT VALUES) 
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OPERATION NAME: Inclusion 



SYMBOL: 
DESCRIPTION : 

EXAMPLE(S): 

> 100 LIST 10/50 

> 100 D20/50 

> TEST 1/3 



/ (slash) 

Allows the operator to enter multiple numbers 
X/Y meaning X through Y inclusive. (Also see the 
Divide Special Character.) 



(list statement 10 through 50) 
(delete statement 20 through 50) 
(select test of Sections 1 though 3) 
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I | SECTION I 

OPERATORS I I 1 

I I VI I 



6.0 INTRODUCTION 

The Operators available to the programmer are listed in detail in 
this section. The format for each Operator explanation is: 

OPERATION NAME: General phrase of what the Operator does. 

MNEMONIC: The form that the Operator would be used in. 

DESCRIPTION: 



EXAMPLE(S) : 



A detailed explanation of the Operator's 
function. 

One or more examples using the Operator. 



«.l ASSIGNMENT!:-) 

OPERATION NAME: Assignment 

SYMBOL: :» 



DESCRIPTION: 



EXAHPLE(S): 



Assigns the value of an expression to a variable 
or buffer. (See the LET statement for further 
examples and explanation.) 



> 10 LET A:=2*B+1 

> 20 LET &AA(0,5):="HELL0! 



> 30 LET BB(«):*!F 



(&AA(0)=H 
&AA(1)=E, 
&AA(2)=L.ETC.) 
.BB(U) 'HEXADECIMAL F 



6.2 INTEGER MULTIPLY (*) 

OPERATION NAME: Single Word Integer Multiply 



SYMBOL: 
DESCRIPTION: 



Executes an integer multiply on two values. The 
multiplication product is limited to the range 
of a single word integer (i.e., ■ -32,768 to 
32,767). Integer overflow during execution will 
cause an abort with an error message. 
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EXAMFLE(S): 



> 10 LET B:«2 

> 20 LET A:«B*20000 

> 30 LET A:»B*2 



.WILL RESULT IK AN OVERFLOW. 
.A • 4 



«J INTEGER MVIDE (/) 

OPERATION NAME: Single Word Integer Divide 

SYMBOL: / 

DESCRIPTION: Executes a single word integer divide on two 
single integers . To access the remainder from 
the divide, the MOD Operator may be used. 
Divide by zero during execution will cause an 
abort and an error message. (Also see the spe- 
cial inclusion character (/).) 



EXAMPLE(S): 



> 10 LET A:«t,B:-U 

> 20 LET C:«B/A 

> 30 LET D:-B MOD A 



.C-2 QUOTIENT 
-D-3 REMAINDER 



6.4 INTEGER ADD <+) 

OPERATION NAME: Single Word Integer Addition 
SYMBOL: * 



DESCRIPTION: Adds two single word integers and provides a 

single word result. Overflow (Sum>32767 or 

Sum< -32768) during execution will result in an 
error message and will abort the program. 



EXAMPLE(S): > 10 LET A:«10, B:-30 
> 20 LET C:«A + B 



.c » no 
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6.5 INTEGER SUBTRACT H 

OPERATION NAME: Single word integer subtraction 
SYMBOL: 

DESCRIPTION: Subtracts two single word integers and yields a 
single word result. Overflow (Dif ference>32767 
or Dif ference< -32768) during execution will 
result in an error message and program abort. 

EXAMPLE(S): > 10 LET A:=« 

> 20 LET B:=10 

> 30 LET C:=A-B C=-6 



6.6 NOT 

OPERATION NAME: Ones Complement 



MNEMONIC : 

DESCRIPTION : 
EXAMPLE(S): 



NOT 

Executes ones complement arithmetic on a value 
(all zeroes to ones, all ones to zeroes). 



> 10 LET A:— 1 

> 20 LET B:=N0T A 



.A=-l OR TRUE* 
.B=0 OR FALSE* 



6.7 EQUAL W 

OPERATION NAME: 

SYMBOL: 

DESCRIPTION: 



* Any non-zero number is true and zero is false. 



Equal to 



Provides a relational test between two values. 
No assignment is made. 



EXAMPLE(S): > 10 IF A = B THEN 20 (GO TO 20 IF A=B) 

> 20 LET A:=B=C (A IS SET TO -1 IF B IS EQUAL TO C 
ELSE A IS SET TO 0) 
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6.8 NOT EQUAL TO <<>) 



OPERATION NAME: Not Equal to 

SYMBOL: <> 

DESCRIPTION: Provides an equality test between two values. 

EXAHFLE(S): 

> 10 IF A <> B THEN 20 .GO TO 20 IP A DOESN'T EQUAL B. 

> 15 .A AND B ARE UNALTERED. 



> 20 LET C:»A<>B 



.C IS SET TO -1 IF A<>B OR IF 
A*B. 



6.9 GREATER OR LESS THAN (> OR <) 



OPERATION NAME: Greater or Less Than 

MNEMONIC: > or < or >« or <« 

DESCRIPTION: Provides a relational test between two values. 
No assignment is made. 



EXAMPLE(S): 

> 10 IF A>B THEN 20 

> 15 

> 20 IF A<-B THEN 40 

> 30 LET A:»B<C 



.IF A IS GREATER THAN BUT NOT 
EQUAL TO B 

.THEN 20. 

.IF A IS LESS THAN OR EQUAL TO 
B THEN HO 

.A«-l IF B IS LESS 
THAN C ELSE A *0 
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6M LOGICAL AND 



OPERATION NAME: Logical And 

KNEHONIC: AND 

DESCRIPTION: Provides a Logical AND of two values. 

EXAMPLE(S): > 10 LET A:-1C7 

> 15 LET B:»!B5 

> 20 LET C:«A AND B .C-185 

> 30 IF A AND B THEN 20 

(A AND B ARE ANDED AS ! 85 THEN 

TESTED FOR TRUTH (NON-ZERO)) 



all LOGICAL OK 

OPERATION NAME: Logical OR 

MNEMONIC: OR 

DESCRIPTION: Provides a Logical OR of two values. 

EXAMPLE(S): > 10 LET A:»iC7 

> 15 LET B:-!B5 

> 20 LET C:-A OR B .C=!F7 

>~30 IF A OR B THEN 20 .A AND B ARE 0R-ED AS !F7 THEN 
.TESTED FOR TRUTH (NON-ZERO) 



412 EXCLUSIVE OR 

OPERATION NAME: Exclusive Or 

MNEMONIC : XOR 

DESCRIPTION: Provides a Logical Exclusive OR of two values. 

EXAMPLE(S): > 10 LET A:=!C7 
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> 20 LET B:-!B5 

> 30 LET C:-A XOR B .C-!72 

> U0 IF A XOR B THEN 20. A AHD B ARE XOR-ED AS !72 

.THEN TESTED FOR TRUTH (non-zero) 



6.13 MODULO OPERATION 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION : 

EXAMPLE(S): 



Modulo Operation 

MOD 

Provides a means of determining the remainder of 
a division process. 



> 10 LET A:-10 

> 20 LET B:*A MOD 3 



.B-l 



6.14 LOGICAL SHIFT OPERATIONS 

OPERATION NAME: Logical Shift 
MNEMONIC: LSL x or LSR x 



DESCRIPTION: Logically shifts a value x places where x may be 
any value. A logical shift corresponds to a log- 
ical divide(LSR) or a logical multiply(LSL) . 
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Bits I All 16 bits 
1 

Lost 1 shifted left 



O's In«>— I 



O's In LSL 



I All 16 bits I Bits 



I- 



LSR 



shifted right I Lost 



EXAMPLE(S): 

> 10 LET A:»A LSR 2 

> 20 LET B:-C LSL 1 

> 30 LET C:-5 LSL A 



.Shift A logically 2 places right 
.Shift C logically 1 place left. 
.Shift 5 logically (A) places left 



6.15 ARITHMETIC SHIFT OPERATIONS 

OPERATION NAME: Arithmetic Shift 
MNEMONIC: ASL x or ASR x 

DESCRIPTION: Arithmetically shifts an integer value x places 
where x may be any value. An arithmetic shift 
corresponds to an integer divide(ASR) or an 
integer aultiply(ASL) . 



Bits Lost 



Sign I 
Unchanged I 



I 



| 15 bits shifted I O's IN 



ASL 



I 



l<- 



Left 



I I 15 bits shifted I Bits Lost 

J • J | > ASR 

j | Right | 
* Copy Sign bit x times. 
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EXAMPLE(S): 

> 10 LET A: -A ASL 2 

> 20 LET B:-C ASR 1 

> 30 LET C:-5 ASL A 



.Shift A arithmetically 2 places 

left. 
.Shift C arithmetically 1 place 

right . 
.Shift 5 arithmetically (A) 

places left. 



«J« CIRCULAR SHIFT OPERATIONS 

OPERATION NAME: Circular Shift 

MNEMONIC: CSL x or CSR x 

DESCRIPTION: Executes a Circular Shift on an integer value x 
places where x may be any value. 

i All 16 bits j 
•<-l l-<. CSL 

! I shifted left | | 

I • • i 

■ > i 

j All 16 bits j 
•>-l |->. CSR 

I I shifted right | | 
j • . | 

<--- ■ 

EXAMPLECS): 

> 10 LET A: "A CSL 8 .Circular Shift A 8 places left. 

> 20 LET B:«C CSR 1 .Circular shift C 1 place right. 

> 30 LET C:»5 CSR A .Circular shift 5 (A) places right 
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6 17 SPECIAL RELATIONAL OPERATORS 

OPERATION NAME: Special Relational Operators 



MNEMONIC : 



NE (Not Equal), EQ (Equal To), LT (Less Than) 
GT (Greater Than), LE (Less Than or Equal To), 
GE (Greater Than or Equal To) 



DESCRIPTION- These special operators may be used only in the 
IF-THEN and IFN-THEN statements. The operators 
NE, EQ, LT, GT, LE and GE may be used to logi- 
cally AND up to three expressions which deter- 
mine whether a branch should occur to the "THEN" 
statement. Evaluation of the "IF" expressions 
occurs left to right. 

EXAMPLE(S): 

> 10 IF 5 LT A LT 10 THEN 150 

(This statement is evaluated as: 

IF (5<A) AND (A<10) THEN GO TO 
STATEMENT 150) 

> 50 IF A:=R MOD 200 LT THEN 60 

(This statement says: 

IF (A:=R MOD 200)<0 

THEN 60). 

Note that A is not stored with 

a relational result (see next 

example ) . 

> 70 IF A:=R MOD 200<0 THEN 50 

(This statement would store A with 
a True or False value R MOD 200<0) 

FOR MORE EXAMPLES SEE THE "IF" STATEMENT. 
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SECTION 
VII 



7.6 INTRODUCTION 

The Reserved Variables available to the operator are listed in 
detail in this section. The format for each Reserved Variable 
explanation is: 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 
INITIALIZED TO: 
EXAMPLE(S): 



General phrase of what the Reserved Variable 
means. 

The form that the Reserved Variable would be 
called in. 

A detailed explanation of the Reserved Vari- 
able's function. 

Displays the value the Reserved Variable is set 

to at the start of program execution (i.e., at 

RUN time). 

One or more examples using the Reserved 

Variable. 



71 BADINTP 

OPERATION NAME: Bad Interrupt 

MNEMONIC : BADINTP 

DESCRIPTION: Should an interrupt occur from an unexpected 
device or multiple interrupts occur from an 
expected device, the erroneous 1MB number/ 
channel/device is stored in BADINTP* . Some 
diagnostics will use this information to test 
interrupt operation. If BADINTP is non-zero 
when an RSIO statement is executed, AID will 
report an error. 

INITIALIZED TO: Zero 



EXAHPLE(S): 



> 1000 RSIO AA .START CHANNEL PROGRAM 

> 1010 IF BADINTP < >0 THEN 2000 

> 1020 .OK - TRY NEXT STEP 



Bits 9-12- Channel and Bits 13-15= Device 
Bits 7-8 ■ 1MB number 
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7.2 CHANNEL 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION : 



Set I/O Channel Number 
CHANNEL 

Specifies the channel number of the I/O device 
to be used in subsequent I/O or channel program 
operations. 



INITIALIZED TO: Zero 



EXAMPLE(S): 



10 LET CHANNEL:- 2. DEVICE : "0 (Following I/O operations w U1 „. 
.„ execute on Channel 2, Device 0) 



TJ CONCHAN 
OPERATION NAME: 
HNEMOMIC: 
DESCRIPTION: 



Console Channel Number 
CONCHAN 

This Reserved Variable is initialised to the 
channel device number of the AID Console where 
bits 9-12- channel and bit 13-15«d«vice. 



INITIALIZED TO: Console Channel-Device number 

EXAMPLE(S): > 10 PRINT "AID CONSOLE CHANNEL- "; KONCHAN 
> 20 RUN 



T.4 DEVICE 
OPERATION NAME: 
MNEMONIC: 
DESCRIPTION: 



AID CONSOLE CHANNEL»*10 

Set I/O Device Number 
DEVICE 

Specifies the device number of the 1/0 device to 
be used in subsequent 1/0 or channel program 
operations. 



INITIALIZED TO: Zero 

EXAMPLEfS} * 

> 10 LET CHANNEL: -2 .DEVICE: -4 (Following 1/0 operations will 
____ execute on channel 2, device «) 
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IS FILEINFO 

OPERATION NAME: File Information 

MNEMONIC : FILEINFO 

DESCRIPTION: After a FILENAME statement has executed FILEINFO 
contains the following information about the 
file: 

Bit =1 if file protected otherwise 
Bit 8/11 =Type of the file 
Bit 12/15 'Class of the file 

(Refer to Diagnostic/Utility System Reference Manual.) 

INITIALIZED TO: Zero 

EXAMPLE(S): Assume the file XYZ is protected, class 

1 ( diagnostic ) , type l(SPLII) and length is 256 
words : 

10 DB &AA,10,"XYZ " 

20 FILENAME &AA(0) 

30 LET A: =FILEINF0 AND %100000 LSR 15 

UO LET B: -FILEINFO AND *360 LSR 1 

50 LET C:=FILEINF0 AND *17 

60 PRINT &AA(0,2);" file "."PROTECT BIT=";A;2; 

70 PRINT "Class-" ;B;2;"Type=";C;2;"Length=";FILELEN 

80 RUN 

XYZ file 

PROTECT BIT=1 Class=l Type=l Length=256 
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7.6 FILELEN 



OPERATION NAME: File Length 
MNEMONIC : FILELEN 

DESCRIPTION: After a FILENAME statement has executed, FILELEN 
contains the length of the specified file 
rounded up to the nearest 128 word sector 
boundary . 

INITIALIZED TO: Zero 



EXAMPLE(S) : 



See FILEINFO Reserved Variable example. 



7.7 COPAJtAMI/COTARAMl/COPARAMS 

OPERATION NAME: Co Parameters 

MNEMONIC: GOPARAM1/GOPARAM2/GOPARAM3 



DESCRIPTION: Allows the executing program to access up to 
three parameters that may have been passed dur- 
ing the last GO Command. The default value of 
unpassed parameters is 0. 



INITIALIZED TO: Zero 



EXAMPLE(S): 

> 10 IF G0PARAM2-2 THEN 50 (IF THE SECOND PARAMETER 

IN THE GO COMMAND WAS 2 

THEN GO TO 50) 



-or- 



> GO 4 , , 6 



(G0PARAM1-4 GOPARAH2-0, GOPARAN3-6) 
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7.8 IMBNUM 

OPERATION NAME: Inter Module Bus Number 

MNEMONIC : IMBNUM 

DESCRIPTION: For the 3000 Series 6U , specifies the 1MB number 
(0<IMBNUM<3) of the I/O device to be used in 

subsequent I/O or channel program operations. 
Also specifies the 1MB to use in global operat- 
ions such as ROCL, RMSK, and SMSK. For other 
3000s, IMBNUM is implied to be zero. 

INITIALIZED TO: ZERO 

EXAMPLE(S): > 10 IMBNUM : »0 

> 20 ROCL A 

> 30 PRINT !A 

> U0 RUN 

!80E0 

79 INDEX 

OPERATION NAME: Buffer Compare Indicator 
MNEMONIC : INDEX 

DESCRIPTION: After a compare buffer (CB) statement has 
executed, INDEX will contain -1 if the buffers 
compared or it will contain the element of the 
first buffer in the CB statement that did not 
compare. 

INITIALIZED TO: Zero 

EXAMPLE(S): > 10 CBAA(10), BB(10),20 .ASSUME AA( 11) <>BB( 11) 

> 20 IF INDEX=-1 THEN 90 .INDEX=11 

> 30 PRINT "GOOD= " ; AA(INDEX) ; "BAD=" ;BB(INDEX) 

> U0 .CHECK THE REST OF THE BUFFER 

> 50 IF INDIEX=29 THEN 90 -DONE? 

> 60 FOR INDEX := INDEX ♦ 1 UNTIL 29 
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> 70 IF AA(INDEX)<>BB(IKDEX) THEN 30 

> 80 NEXT 60 

> 90 .NEXT STATEMENT 



7.10 INPUTLEN 

OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

INITIALIZED TO: 
EXAMPLE(S): 



Last Input character Length 

INPUTLEN 

This Reserved Variable contains the character 
length of the last input of the most recently 
executed INPUT statement. 

Zero 

> 10 

> 20 

> 30 



INPUT A 

PRINT INPUTLEN 

RUN 



? 137 

3 (INPUTLEN- 3) 

-or- 

> 10 INPUT A.B 

> 20 PRINT INPUTLEN 

> 30 RUN 

? 137,26 

2 (LAST INPUT WAS 2 CHARACTER,! .E. -ASCII 26) 

-or- 

> 10 INPUT &AA(K,10) 

> 20 PRINT INPUTLEN 

> 30 RUN 
? HELLO 

5 

- (INPUTLEN=5 EVEN THOUGH 7 CHARACTERS WERE 
EXPECTED) 
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7.11 MAXMEMORY 
OPERATION NAHE: 
MNEMONIC : 

DESCRIPTION: 

INITIALIZED TO: 
EXAMFLE(S): 
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Maximum Buffer Area 

MAXMEMORY 

Dynamically indicates the amount of unused 
buffer space available to the executing program. 

Memory space available prior to RUN time 

> 20 IF MAXMEMORY < 4000 THEN 50 

> 30 DB AA, 4000 

> 40 GOTO 60 

> 50 DB AA, 2000 

(IP THE DB AT 30 WAS EXECUTED THEN MAXMEMORY 
WOULD THEN EQUAL MAXMEMORY - 4000) 



712 NEWTEST 

OPERATION NAME: Test Command Indicator 

MNEMONIC : NEWTEST 

DESCRIPTION: This Reserved Variable may be used to determine 
if a test section sequence has been specified 
externally. NEWTEST is set to false when a TEST 
command is entered with no parameters and stays 
false until a TEST Command with parameters is 
entered . 

INITIALIZED TO: Not altered at RUN time 

EXAMPLE(S): The XYZ Program has ten sections that are 
executed as a standard test and Section 11 which 
is optional. A typical entry sequence would be: 



> 10 IF NEWTEST THEN 30 

> 20 LET SECTIONS 1:*!FFDF .CLEAR SECTION 11 

INDICATOR 

> 30 .continue 



(See Reserved Variables SECTIONS 1/3 and Command TEST for further 
explanations . ) 
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7J3 NOINPUT 

OPERATION NAME: Non-Error Print Indicator 
MNEMONIC: NOINPUT 



DESCRIPTION: NOINPUT is true if non-error print is suppressed 
(i.e., the SNFR Command was executed). This 
allows the executing program to determine if a 
PRINT, INPUT statement sequence should be exe- 
cuted (i.e., if non-error print is suppressed 
then no INPUT statement will be executed there- 
fore rendering any test of the input data 
invalid). Setting NOINPUT to false will override 
the SNPR command but should be used with 
caution. 



INITIALIZED TO: Zero 

EXAMPLE(S): > 10 IP NOINPUT THEN 50 

> 20 PRINT "DO YOU WANT TO CONTINUE?" 

> 30 INPUT & AA(0) 

> 40 IF &AA(0) - "Y" THEN 400 

> 50 END 

> 60 .NEXT STATEMENT 



If an SNPR command has been previously entered, then the 
will skip past the INPUT sequence of statements 20 to 40. 



program 



714 NORESPONS 

OPERATION NAME: 
MNEMONIC : 



No Response to I/O Flag 
NORESPONS 



DESCRIPTION: If an I/O instruction or channel program execu- 
tion returns an error condition and this 
Reserved Variable is still equal to then AID 
will handle the error. However, if the user pro- 
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gram has changed the value of NORESPONS to non- 
zero then AID will set NORESPONS (see table 
below) and not report an error. By setting 
NORESPONS to a value other than the user pro- 
gram can handle the no response error. 



NORESPONS Reserved Variable Format 
0123«56789 12 13 



15 



1 1 BIB |N0|I 


> IT ID |< 


I It BIT 


3 BIT 1 


1 1 AIA IH IN 


10 IS 1 


| CHANNEL 


DEVICE 1 


1 1 DID II IT 


1 1 1 






I IPTIINIO IS 


1 1 1 






1 1 1 IP 1 


1 1 1 







If N0RESPONS< >0 when a channel error occurs then: 
Bit Meaning (if set) 




1 
2 

3 

4 
5 
6 
7 
8 
9-15 



reserved 

DRTO not pointing to channel program 

Illegal interrupt from device in Bits 

and bits 7/8 of N0RESPNS2 

HIOP did not halt channel program 

too many device interrupts 

CCG returned after I/O command 

channel program time out (approx. 

channel program did not start 

CCL returned after I/O command 

channel-device number when error occurred 

(bits 9-12=channel number, bit 13-15=device) 



9/15 



10 sec . ) 



INITIALIZED TO: Zero 

EXAMPLE(S): > 10 LET NORESPONS: -2 

> 20 LET CHANNEL: =2, DEVICE: -7 

> 30 INIT 

Wo IF NORESP0NS=2 THEN 60 .CHECK IF INIT WAS OK? 

"50 GOSUB 1000 .NO! PROCESS NORESPONS ERROR 

> 60 .ADDITIONAL CODE 
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7.15 NORESPNS2 

OPERATION: No Resonse to I/O Flag - Second Word 

MNEMONIC : N0RESPNS2 

DESCRIPTION: This reserved variable is an extension of 
NORESPONS. Bits 0-6 and 9-15 are reserved for 
future use. Bits 7-8 are the 1MB number when the 
error occurred. 



716 OFFSET 

OPERATION NAME: Vary Return Point 

MNEMONIC : OFFSET 

DESCRIPTION: OFFSET may be used to vary the statement number 
returned to when executing a RETURN statement . 
OFFSET is set to zero when starting execution 
and after a RETURN statement execution. OFFSET, 
if used, may be set to any integer value indi- 
cating the number of statements after (if posi- 
tive) or before (if negative) the normal return 
statement to return to. 

INITIALIZED TO: Zero 

EXAMPLE(S): > 10 PRINT "Input yes or no" 

> 20 INPUT &AA(0) 

> 30 GOSUB 500 .GO CHECK FOR YES OR NO 

> HO GOTO 100 .GO TO "YES" ROUTINE 

> 50 .START NO ROUTINE 

>500 IF iAA(0)-"Y" THEN 5*0 .RETURN NORMALLY 

>510 LET OFFSET: »1 .FORCE RETURN TO 50 

>520 IF &AA(0)-"N" THEN 510 

>530 LET OFFSET:— 3 .FORCE RETURN TO 10 

>510 RETURN 
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717 PASSCOVNT 

OPERATION NAME: Execution Pass Counter 

MNEMONIC: PASSCOUNT 

DESCRIPTION: May be used to maintain a program passcount . 
Each time a BUMP statement is executed, PASSCOUNT 
is incremented. (See BUMP statement.) 

INITIALIZED TO: Zero 

EXAMPLE(S): 

> 200 .END OF PROGRAM 

> 210 BUMP .INCREMENT PASSCOUNT AND PRINT IT 

> 220 GOSUB 500 .GO CHECK FOR LOOP 



-or- 
>290 .Display PASSCOUNT 
>300 LET PASSCOUNT :=PASSC0UNT+1 
'310 PRINT "End of pass ";PASSCOUNT 

7.18 RUNPARAM1/RUNPARAM2/RUNPARAM3 

OPERATION NAME: Run Parameters 

RUNPARAM1/RUNPARAM2/RUNPARAM3 



MNEMONIC : 
DESCRIPTION: 

INITIALIZED TO: 
EXAMPLE(S) : 



Allows the executing program to access up to 
three parameters that may have been passed dur- 
ing the last RUN Command. The default value of 
unpassed parameters is 0. 

Parameters input with the RUN Command 



> 10 IF RUNPARAM2=2 THEN 50 

-If the second parameter in 

. the RUN command was 2 then 
.go to 50 
or 

> 10 RUN 2,,U (RUNPARAM1=2, RUNPARAM2=0, RUNPARAM3=«) 
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719 SECTION 

OPERATION NAME: Section Number 
MNEMONIC : SECTION 



DESCRIPTION: During program execution, any SECTION statement* 
will alter the SECTION Reserved Variable to the 
current section number if the section is 
executed. 



INITIALIZED TO: Zero 



EXAMPLE(S) : 



(Assume TEST 10 was entered prior to execution) 

> 100 SECTION 10,300 .SECTION RESERVED VARIABLE SET TO 10 

> 300 SECTION 11.U00 



(SECTION IS UNCHANGED BECAUSE 
SECTION 11 WILL NOT BE EXECUTED) 



• Do NOT confuse the SECTION statement with the SECTION 
Reserved Variable. 
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7.20 SECT1QNS1/SECTIONS3/SECT10NS3 



0FERATI0H NAME: Section Execution Indicators 

MNEMONIC : SECTI0NS1 /SECTI0NS2 /SECTI0NS3 

DESCRIPTION: During a SECTION statement execution, the bit in 
the Reserved Variable SECTIONS]., SECTI0NS2 or 
SECTI0NS3 correlating to the SECTION statement 
number is extracted, and, if it's a logical "1", 
the next sequential statement (s) will be exe- 
cuted. Otherwise, control is transferred to the 
statement number in the SECTION statement. The 
format is: 

Bit 15 

....__.-------------- ^ SECTIONS1 

"1718""""""""""" 32 SECTIONS2 

~33~3u""""~~""~ "48 SECTI0NS3 

These variables are altered by the TEST command or, 
if no TEST has been entered, at RUN time where they 
are stored with all "ones". 

INITIALIZED TO: Minus one if no TEST Command (without parameters) 
was entered otherwise not altered . 



EXAMPLE(S): 



TEST 



1.17,33 (Bit of SECTI0NS1/3 are set to "1" and 

the rest are set to "0" meaning only 
SECTIONS 1, 17 and 33 may be 
executed . ) 



-or- 



> 10 LET SECTIONSl: 



•SECTI0NS2 : -SECTI0NS3 : - ! 8000 

(Yields the same result as the 
TEST command above when executed) 
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Til STATENUM 
OPERATION NAME: 
MNEMONIC : 
DESCRIPTION : 

EXAMPLE(S): 



Statement Number 

STATENUM 

STATENUM contains the AID statement number of 
the last function call to be executed. 

> 10 GOTO 50 

> 20 FUNCTION SAMPLE 

> 30 PRINT STATENUM 

> 10 ENDP 

> 50 SAMPLE 

> 60 RUN 



50 
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121 STEP 

OPERATION NAME: Step Number 

MNEMONIC : STEP 

DESCRIPTION: STEP is provided so that the user's current STEP 
number may be available to AID or the user pro- 
gram. A positive and non-zero value in STEP will 
cause PPRINT and EPRINT Statement messages to be 
preceded by a header message indicating the pro- 
gram is in that STEP. 

INITIALIZED TO: Zero 

EXAMPLE(S): > 5 .START STEP 1 TO CHECK XYZ 
> 10 LET STEP:-1 



.A FAILURE ANYWHERE MAY DESIGNATE 
.THE STEP NUMBER. 
> 1000 .END OF STEP 1 



> 10 .START STEP 2 TO CHECK ABC 

> 20 LET STEP: -2 

> 30 PPRINT* "HELLO" 

> HO EPRINT* "ERROR" 

> 50 RUN 

Step 2: HELLO 

Error in Step 2: ERROR 

End of AID user program 
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7.23 TIMEOUT 

OPERATION NAME: Channel Program Timeout Flag 

MNEMONIC : TIMEOUT 

DESCRIPTION: To disable the software timer (default approxi- 
mately 10 seconds), the user program may set 
TIMEOUT equal to -1. To increase the default 
timeout by N times 10 seconds, the user may set 
TIMEOUT to N in an assignment statement. 

INITIALIZED TO: Zero 



EXAMPLE(S): 



10 .SET UP FOR SCOPE LOOP 

20 LET CHANNEL: -2 

30 TIMEOUT :»-l .DISABLE 1/0 TIMEOUTS 

HO DB CC, 3, 11400 .READ DISC ADDRESS 

50 BSI0 AA 

60 WR 8,CC(0),2 

70 RR 8,CC(1),4 

80 JUMP 60 

90 RSI0 

100 RUN 
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7.24 TRUE or FALSE 

OPERATION NAME: Truth Assignment 

MNEMONIC: TRUE or FALSE 

DESCRIPTION: Allows the programmer the ability to manipulate 
or assign variables as Boolean Values (even 
though they are really manipulated arithmeti- 
cally internally) . 

INITIALIZED TO: TRUE is set to -1 and FALSE is set to 



EXAMPLE'S): > 10 LETA:=FALSE .A=0 

> 20 LET B:=TRUE .B « -1 
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I I 



I | SECTION 



VIII 



8.0 INTRODUCTION 

The AID I/O Statements that do not reside within the BSIO-ESIO 
instructions are listed, in detail, in this section. The format 
of each statement explanation is: 



OPERATION NAME: 
MNEMONIC : 



DESCRIPTION: 
EXAMPLE(S): 



General phrase of what the Statement does . 

The form that the Statement would be called in. 
X is used to indicate the variables A to Z or a 
number. XX is used to indicate the buffers AA 
to ZZ. N is the same as X but is used as an 

index (XX(n)). 

A detailed explanation of the Statement's function. 
One or more examples using the Statement . 



8.1 ADDRESSOFF/ADDRESSON 

OPERATION NAME: Prevent address increment 

MNEMONIC : ADDRESSOFF/ADDRESSON 

DESCRIPTION: Prevent (ADDRESSOFF) or allow (ADDRESSON which 
is the default) channel program data buffer 
address from updating after each byte transfer. 
These indicators determine the state of Bit I* of 
Word i< of Read/Write Channel instuctions. 
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82 BSIO 

OPERATION NAME: Begin Channel Program 
MNEMONIC: BSIO XX [ ,C] 



DESCRIPTION: This statement is used to mark the start of the 
definition of a Channel program. During user 
program execution, the Channel Program is com- 
pletely defined when the ESIO or RSIO statement 
is reached. No direct I/O or DB statements may 
be placed within a BSIO-ESIO pair. 

The Channel program is stored in buffer XX. Any 
previous definition of XX is purged. C is the 
number of copies to make (1<»C<*8). Default 
for C is 1 . XX has the following format when 
the definition is complete: 



Word(s) 



Definition 



Length (quantity n*) of Channel program. 

1 (bits 0-7) Number of words (quantity s*) to save after 

channel program executes. Examples of cases 
where needed are RREG and DSJ. 

1 (bits 8-15) Number of copies minus one. 

2 Dirty** copy mask where bit0-bit7 indicate 
status of copies l-8(dirty«Bit set). 

3-U SPARE 

5 to n + 4 Master copy of Channel program. 

* The quantities n and s are used in formulas under the WORD(S) 
heading. 

••Dirty implies already executed (therefore needing recopying 
before another execution is attempted) . 



n*5 to n*4+(2*s) Two word pairs for saving words after the 
channel program executes. First word-relative 
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location within Channel program. Second woj-u- 
relative location of variable. 



n+5+(2*s) to Place to put first copy of Channel program. 

2n+4+(2*s) (First copy is copy 0.) 

2n+5+(2*s)to Place to put second copy of Channel program. 

3n+U+(2*s) (If c>l) 



8n+5+(2*s) to Place to put eighth copy of Channel program. 
9n+«+(2*s) (If c>7) 



EXAMFLE(S): > 10 LET CHANNEL:=5 .Define Disc 

> 20 DB AA,3 .Create Buffer 

> 30 LET AA(0):=!303 .Disc Status Command 

> 40 .To Unit 3 

> 50 GOSUB 200 .Get Disc Status 

> 60 PRINT "DISC STATUS - " ; AA(1) ; AA( 2) 

> 65 .Output Result 

> 70 END 

>200 BSIO BB .Build Channel Program to 

>210 Get Status from the Disc 

>220 WR 8,AA(0),2 .Output Status Command 

>230 RR 8,AA(1),4 .Input Two Status Words 

>240 IN H .End of Channel Program 

>250 RSIO -End of Definition of 

>260 .Channel Program — Start 

>270 .Execution 

>280 RETURN 
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8.3 COPY 

OPERATION NAME: Copy Channel Program 
MNEMONIC: COPY XX [*N] 



DESCRIPTION: 



EXAMFLE(S) : 



Duplicates the master channel program in XX into 
all copies of XX. If the optional *N is added, 
then only the Nth copy of XX will be duplicated. 
Since the RSIO instruction automatically dupli- 
cates copies, COPY would be needed if modifica- 
tion to a channel program is needed before 
execution. (See example.) Note: Copy number 
is the first channel program copy. 

10 LET CHANNEL:=2,DEVICE:=4 

20 ESIO AA,3 .CREATE 3 COPIES OF CHANNEL PROGRAM 

30 IN H, 1,5 

U0 ESIO 

50 LOCATE 30, A .GET IN H POINTER TO COPY 

60 LET AA(A):=6 .CHANGE HALT CODE TO 6 IN COPY 

70 RSIO AA.O .RUN FIRST COPY 

80 COPY AA»0 .DUPLICATE FIRST COPY ONLY 

90 GOTO 60 .LOOP ON CHANNEL PROGRAM 



84 CPVA 

OPERATION NAME: Set User CPVA 
MNEMONIC: CPVA XX(N) 

DESCRIPTION: Sets a pointer to the data buffer XX(N) as the 
CPVA during subsequent channel program execu- 
tions. The data buffer XX must be declared at 
least 7 words long. If this statement is not 
used, the CPVA pointer defaults to absolute mem- 
ory and is not accessible by the user. 

EXAMPLE(S): > 10 DBAA.7.0 



> 20 LET CHANNEL:- 3, DEVICE :«1 

> 30 CPVA AA(0) .SET CPVA POINTER TO AA(0) 
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OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

EXAMPLE(S): 



End Channel Program Definition 

ESIO 

This statement is used to mark the end of the 
definition of a Channel program. 

See BSIO 



(.< HIOP 



OPERATION NAME: 
MNEMONIC : 
DESCRIPTION: 

EXAMPLE (S): 



Halt Channel Program 

HIOP 

This statement, when executed, will terminate 
the channel program executing on the currently 
selected device. 

> 10 LET CHANNEL: =5 

> 20 PROC .SET PROCEED MODE 

> 30 BSIO AA 

> 40 JUMP 50 

> 50 JUMP 10 

> 60 RSIO .Start Program Which Never Ends 

> 70 HIOP .Stop Channel Program 
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8.7 INIT 

OPERATION NAME: Initialize I/O Channel 
MNEMONIC : INIT 



DESCRIPTION: This statement will initialize the currently 
selected channel. The following actions take 
place. 

(1) Operations in progress on the channel are terminated. 

(2) The channel interrupt enable bit is cleared. 

(3) Channel registers are set to initial values. 
(U) HP-IB is set to idle state. 

(5) The fourth word of each DRT for this channel is cleared. 

(6) The mask bit for this channel is cleared 



88 !OCL 



OPERATION NAME: 
MNEMONIC : 



I/O Clear 

IOCL 



DESCRIPTION: This statement will clear all I/O channels on 
the selected 1MB . The following actions 'ake 
place : 

(1) Operations in progress on each channel on the selected 1MB 
are terminated. 

(2) All channel interrupt enable bits are cleared. 

(3) Channel registers are set to initial values. 

(4) All HP-IBs are set to the idle state. 

(5) The fourth word of each DRT is cleared. 

(6) All mask bits are cleared. 
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»3 ION/IOFF 



OPERATION NAME: Enable/Disable External Interrupts 

MNEMONIC: ION/IOFF 

DESCRIPTION: IOFF will disable the external interrupt system 
by clearing the interrupt bit in the status 
register. Use ION to enable external 
interrupts . 



810 LOCATE 

OPERATION NAME: Locate a Channel Program Element 
MNEMONIC: LOCATE [(copy),] label [(of fset) ] .variable 



DESCRIPTION: Finds the element within a channel program buf- 
fer correlating to the second word of a channel 
program instruction (specified in label) and 
stores that word in the parameter variable. If 
the optional copy is used (where 0<"copy<«7 and 
default is 0) then that copy of the channel pro- 
gram is used. If the optional offset is added 
(default is offset from the second word of the 
channel instruction) then that many words are 
added (or subtracted) to the result stored in 
the parameter variable. 



Note: 



Copy number is the first channel 
program copy. 



EXAMPLE(S): > 10 LET CHANNEL :»2 

> 20 BSIO AA 

> 30 IN H, 1,3 

> U0 ESIO 

> 50 LOCATE 30, A .GET POINTER TO 2ND WORD OF IN H 

> 60 LET AA(A):=5 CHANGE HALT CODE TO 5. 
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111 PROC 

OPERATION NAME: Proceed 



MNEMONIC : 
DESCRIPTION: 



PROC [N] 

This statement is used to enable(or disable when 
the N is added) the proceed mode. AID normally 
waits for each Channel program to interrupt be- 
fore continuing to the statement following the 
RSIO. This normal mode of having I/O with wait 
may be changed to the proceed mode (i.e., I/O 
without wait) by using this statement. 

EXAMFLE(S): (Assume AA and BB are predefined Channel program 
buffers ) 



> 990 PROC 

> 1010 LET CHANNEL: »2 

> 1020 RSIO AA 

> 1030 LET CHANNEL: «3 

> 1040 RSIO BB 

> 1050 PROC N 



.PERFORM 'I/O WITHOUT WAIT 

.START CHANNEL PROGRAM AA 

.START CHANNEL PROGRAM BB 
.WAIT HERE FOR 1/0 TO FINISH 



S.12 RDRT 

OPERATION NAME: Read DRT Word 

MNEMONIC: RDRT Z,X 

RDRT Z,XX(N) 

DESCRIPTION: The DRT (device reference table) entry is 
selected by the currently selected channel 
device. Z is the DRT word to read (0 <= Z <= 
3). The word read is stored in X or XX(N) . 



EXAMPLE(S): > 10 LET CHANNEL: =2 

> 20 RDRT 3, A .PLACE DRT WORD 3 IN A 
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OPERATION NAME: Read I/O Channel 



MNEMONIC : 



RIOC K, XX(N) [,C] 
RIOC K, X [,C] 



DESCRIPTION: This statement will issue a command C (where 
0<=C<=!F and the default is 0) to register K (0 
<= K <» !F) on the currently selected channel. 
The result is placed in X or XX(N). 



EXAMPLE(S): 



> 10 LET CHANNEL: =2, DEVICE: =5 

> 20 RIOC 3. A .Read I/O Register 3 into A 

> 30 PRINT "REG 3 = "; !A 

> 40 RUN 



814 RMSK 



REG 3-ltOlU 

End of AID user program 



OPERATION NAHE: 
MNEMONIC : 

DESCRIPTION: 



Read Interrupt Mask 

RMSK X 
RMSK XX(N) 

This statement will read the mask word (memory 
location 7 for Series 30, 33. to, and UU and 
memory location 26 plus 1MB number for Series 
61) for the selected 1MB. 



EXAMPLE(S) : > 10 RMSK A 
> 20 RUN 



MASK WORD 
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8.15 ROCL 

OPERATION NAME: 
MNEMONIC : 

DESCRIPTION: 



Channel Roll Call 

ROCL XX(N) 
ROCL X 



EXAMPLE(S): 



This statement will place an interrupt mask in 
XX(N) or X. Each bit of XX(N) or X is set to 
one if the corresponding channel of the selected 
1MB is present . 

10 ROCL A 

20 PRINT "Channels present*"; 

30 FOR Q:=R:«1 UNTIL 15 -See if Channel is present 

40 IFN A LSL Q AND 18000 EQ 18000 THEN 70 .Is it? 

50 PRINT Q;l; .Yes! Print it's number 

60 LET R:=R*1 

70 NEXT 30 

80 IF R<>1 THEN 100 .Any Channels present? 

90 PRINT "NONE"; .No! Tell operator 

100 PRINT 

110 RUN 



S.K RSIO 

OPERATION NAME: 
MNEMONIC : 



Run Channel Program 
RSIO [XX [,[C][,SN]]] 



DESCRIPTION: This statement may be used instead of ESIO to 
terminate Channel program definition. XX (a buf- 
fer) may only be added when outside Channel pro- 
gram definition. See BSIO for more information. 
This statement differs from ESIO in that it 
initiates the Channel program execution. C is 
the copy number (0 <» C <- 7). Default for C 
is 0. SN, if added, is the statement number to 
execute next if an error is detected during exe- 
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cution of the RSIO. Note: Copy number is the 
first channel program copy. 



EXAMPLE(S) : 



> 10 LET CHANNEL: =5 

> 20 BSIO AA 

> 30 IN H 

> 40 RSIO 

> 50 BSIO BB 

> 60 IN H 

> 70 ESIO 

> 80 RSIO AA 

> 90 RSIO BB 
>100 RUN 



.Define Device 
.Create First Program 

.Run First Program 
.Create Second Program 



.Run First Program 
.Run Second Program 



»J7 RSW 

OPERATION NAME: 
MNEMONIC: 

DESCRIPTION: 



EXAMPLE(S): 



Read Switch Register 

RSW X 
RSW XX(N) 

This statement, when executed, will place the 
value of the switch register in X or XX(N) . 
Bits 7-8 hold the 1MB number and bits 13-15 hold 
the device number, and bits 9-12 hold the 
hold the channel number. 

> 10 RSW A 

> 20 PRINT "Switch Register-" ;!A 

> 30 RON 

Switch Register* 120 
End of AID user program 
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8.1S SMSK 

OPERATION NAME: Set Interrupt Mask 

MNEMONIC: SMSK X 

DESCRIPTION: Sends the mask word X to all channels on the 
selected 1MB and a copy is stored in memory 
location 7 for Series 30, 33, "0. and Uif or 
in memory location 26 plus 1MB number for Series 
6U. 

EXAMFLE(S): > 10 LETA:»!U000 

> 20 SMSK A .ENABLE CHANNEL ONE INTERRUPTS. 



U» UPDATEOFF/UPDATEON 

OPERATION NAME: Prevent channel programs from being updated 
MNEMONIC : UPDATEOFF /UPDATEON 

DESCRIPTION: UPDATEOFF prevents words 2,4 and 5 of read and 
write portions of channel programs from being 
updated by the channel program microcode. 
UPDATEON (the default condition) restores updat- 
ing. Updating is indicated by the state of bit 
5 of word U of Read/Write channel instructions. 



120 WIOC 



OPERATION NAME: Write I/O Channel 



MNEMONIC : 



WIOC K, XX(N), [C] 
WIOC K, X, [C] 



DESCRIPTION: This statement will write X or XX(N) into regis- 
ter K (0<=K<»!F) on the currently selected 
channel. The parameters are the same as those 
for RIOC. 
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AID STATEMENTS (CHANNEL PROGRAM TYPE) I |- 



IX 



9.0 INTRODUCTION 

The following Channel Program Type AID Statements must be located 
between the BSIO and ESIO Statements. The format of each state- 
ment explanation is: 

OPERATION NAME: General phrase of what the Statement does. 

MNEMONIC: The form that the Statement would be called in. 
X is used to indicate the variables A to Z or a 
number. XX is used to indicate the buffers AA 
to ZZ. N is the same as X but is used as an 
index (XX(n)). 

DESCRIPTION: A detailed explanation of the Statement's 
function. 

EXAMPLE(S): One or more examples using the Statement. 



».l CHP 

OPERATION NAME: Command HP-IB 



MNEMONIC : 
DESCRIPTION: 



CHP V0,[V1, 



VN] 



This statement executes the Command HP-IB chan- 
nel instruction. VN is the Nth HP-IB command 
(0<*N<=7) and is a reference to a variable or 
buffer element which contains the command or is 
the command in numeric form. 



EXAMPLE(S): > 10 LET CHANNEL:-5, DEVICE:«1 

> 20 BSIO AA 

> 30 CHP !3P,!5E, !25.!6F 

> MO .UNLISTEN, TALK 30, IDS-LISTEN, ENABLE DOWNLOAD 

> 50 RSIO 

> 60 RUN 



NOTE: VN (a 16-bit quantity) is converted to a byte and stored 
in the CHP portion of the channel program. 
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OPERATION NAME: 
MNEMONIC : 
DESCRIPTION : 



Control Clear 

CLEAR [X] 

This statement executes the Clear channel 
instruction. Commands the currently selected 
device to clear itself. If the optional X is 
added it forms the control byte(where 0<«X<-!FF 
and the default is 0) in the channel 
instruction. 



EXAMFLE(S): > 10 LET CHANNEL: -5 

> 20 BSIO AA 

> 30 CLEAR .CLEAR CHANNEL 5. DEVICE 

> 40 RSI0 



» J DSJ 

OPERATION NAME: 
MNEMONIC : 



Device Specified Jump 

DSJ S0[ , R0][,S1[ , R1]...[,SM[ , HM]]...]][;XX(N)] 
DSJ S0[ , R0][,S1[ , R1J...[,SM[»RM]]...]][;XJ 



DESCRIPTION: This statement executes the DSJ channel program 
instruction. A jump occurs as a result of the 
byte returned from the device. If XX(N) or X is 
added, then the byte returned (last byte should 
the DSJ execute more than once) or iFF (if the 
DSJ never executes) is placed in the right byte 
of XX(N) or X. The left byte of XX(N) or X will 
be set to 0. SH is the statement to execute 
when the returned byte of the DSJ is equal to M. 
SM must be in the same Channel program. *RM is 
the total number of jump address copies of SM to 
build into the DSJ instruction. 
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EXAMPLE(S): 



5 DB BB,7,0 

7 CPVA BB(0) 

10 LET CHANNEL: -5 

20 BSIO AA 

30 DSJ 40, 60; A 

40 IN H, 0, 7 

50 

60 IN H 

70 RSIO 



.Define CPVA 

.Define Disc 

.Begin Channel Program 

.Stuff return byte into A 

.Error — Store halt code 7 

.In CPVA0 

.OK— Clear CPVAO 

.Start Execution 



80 PRINT "DSJ«;A;2; "CPVA0-" ;BB(0) 
— . Output Results 



9.4 IDENT 

OPERATION NAME: Identify 

MNEMONIC: IDENT XX(N) 
IDENT X 



DESCRIPTION: This statement executes the IDENT channel pro- 
gram instruction. The word returned from the 
device (last word should it execute more than 
once) or 1FFFF (if it never executes) is placed 
in XX(N) or X. 



EXAMPLE(S): 



> 10 LET CHANNEL: =5 

> 20 DB BB,8 

> 30 BSIO AA 

> 40 IDENT BB(7) 

> 50 IN H 

> 60 RSIO 



.Define Disc 
.Create Buffer 
. Begin Channel Program 
.Stuff ID into BB(7) 
.Stop Execution 
.Start Channel Program 



> 70 PRINT "IDENTIFY CODE =";BB(7) 
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».S IN 



OPERATION NAME: Interrupt Halt or Run 

MNEMONIC: IN H [ , [XH,C]J 
IH R (, [X][.C]] 

DESCRIPTION: Executes the INTERRUPT channel program instruc- 
tion. R, if used, will allow the Channel pro- 
grain to continue to run when this instruction is 
reached. H, if used, will cause the Channel pro- 
gram to halt when this instruction is reached . 
X is the CPVA offset (0 <« X <» 3). C is the 
code to store at CPVAX on interrupt (0<»C< =105) ■ 
Default for both X and C is 0. 



EXAMPLE(S): 
X DB BB.U 

5 CPVA BB(0) .DEFINE CPVA 

6 LET CHANNEL: '5 



10 BSIO AA 

20 IN R,3,l 

30 IN R,2,2 

10 IN R.1,3 

50 IN H,,H 

60 RSI0 



.Define the following Channel Program 



.CPVA3 


- 1 


. CPVA2 


« 2 


.CPVA1 


* 3 



.Stop Program Set CPVA0 : = 4 
.Execute the Above Program 



70 PRINT "CPVAO-";BB(0);2;"CPVA1*!BB(1) 
80 PRINT "CPVA2*";BB(2);2;"CFVA3*";BB(3) 
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OPERATION NAME: Direct Jump 
MNEMONIC: JUMP SN 

DESCRIPTION: This statement executes the JUMP channel program 
instruction. SN is an AID statement number. 
The statement number must be within the same 
Channel program. 

EXAMPLE(S): > 10 LET CHANNEL:=5 .Define Disc 

> 20 BSIO AA 

> 30 DSJ «0, 50; A 

> U0 JUMP 30 

> 50 IN H 

> 60 ESIO 

> 70 RSIO AA 



.Does Disc respond? 

. No ! Wait some more . 

.Yes! Exit Channel program. 



97 RB 



OPERATION NAME: Read Burst 

MNEMONIC: RBMOD, XX(N), BC [ , [BL] [ , [DC=X] [ , [R] [ , [TD] ] ] ] 

DESCRIPTION: This statement executes the Read Burst channel 
program instruction. MOD is the device dependent 
modifier(0<=M0D<=!lF) . If M0D>!F then Read Con- 
trol is used instead of Read. XX(N) defines the 
initial buffer location where the data is to be 
stored. BC is the total number of bytes to be 
read. BL is the burst length (default is 1) 
1<=BL<=256. Burst length is the number of bytes 
to read this time through the RB. DC, if added, 
will allow separate data buffers to be linked 
Chained) by using sequential RB statements. X 
:s equal to number of links to follow. R, if 
added, will cause the data to be stored starting 
in the right byte of XX(N) (default is the left 
byte). TD, if added, is the statement number to 
which channel program execution is transferred 
upon successful completion of the RB. 
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EXAMPLE(S): 



10 LET CHANNEL: =7 

20 BSIO BB 

30 RB 0,AA(0),1 

uo 

50 IN H 

60 RSIO 

-or- 

10 LET CHANNEL: =2 

20 DB AA,1 

30 BSIO BB 

140 RB 31,AA(0),1 

50 IN H 

60 RSIO 



.Begin Channel Program 

. Read One Byte Into 

.Left Byte of AA(0) 

.Done 

.Execute Channel Program 



.Read self test results 



9.8 RDMAB 

OPERATION NAME: READ DMA Burst 

MNEMONIC: RDMAB XX(N), BC[ , [BL] [ , R] ( ,TD] ] ] 



DESCRIPTION: This statement executes the Read DMA Burst chan- 
nel program instruction. The parameters are the 
same as those for RB except the modifier and DC 
are deleted. 



99 ROMAR 

OPERATION NAME: READ DMA Record 

MNEMONIC: RDKAR XX ( N ) , BC [,[R][,TD]] 



DESCRIPTION: This statement executes the Read DMA Record 
channel program instruction. The parameters are 
the same as those for RR except the modifier and 
DC are deleted . 
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OPERATION NAME: Read Modify Write 



MNEMONIC : 



DESCRIPTION: 



RMW K, BN, 
RMW K, BN, 



This statement executes the Read Modify Write 
channel program instruction. K is the register 
to be modified (0<=K<=!F). BN is the bit number 
of register K to modify (0<=BN<=!F). C will 
clear the bit and S will set it. REGISTER K is 
read, bit number BN is modified, then register K 
is written. For some registers BN has special 
meaning . 



911 RR 

OPERATION NAME: Read Record 

MNEMONIC: RR MOD, XX(N) , BC[, [DC=X][, [R][, TD]]] 



DESCRIPTION: This statement executes the Read Record channel 
instruction. MOD is the device dependent modi- 
fier (0<=MOD<=!1F) . If MOD is greater than !F 
then Read Control is used instead of Read. 
XX(N) defines the initial buffer location where 
the data is to be stored. BC is the number of 
bytes to be read. If R if added will cause the 
data to be stored starting in the right byte of 
XX(N) (default is the left byte). DC(data 
chain), if added, will allow separate data buf- 
fers to be linked (chained) by using sequential 
RR statements . X is equal to number of links to 
follow. TD, if added is the statement number to 
which channel program execution is transferred 
upon successful completion of the RR. 



EXAMPLE(S): 

> 100 RR 0,JJ(0) ,256,DC=2 .READ 1 SECTORS. PLACE THE 

> 110 RR 0,BB(0),512,DC-1 . FIRST ONE IN JJ AND THE LAST 

> 120 RR 0,FF(128),256 ONE AT FF(128) 
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912 RREC 

OPERATION NAME: 
MNEMONIC : 



Read Register 

RREG K, XX(N) 
RREG K, X 



DESCRIPTION: This statement executes the Read Register Chan- 
nel instruction. K is the Channel Register to 
be read (0<»K<=!F). XX(N) or X is where the data 
is placed. If this statement does not execute, 
then !FFFF is placed in X or XX(N). Should this 
statement execute more than once, the last value 
read will be placed in X or XX(N). 



»J3 WAIT 

OPERATION NAME: Wait 
MNEMONIC: WAIT [S] 



DESCRIPTION: This statement executes the WAIT channel program 
instruction. The channel program is suspended 
until the device requests service. If S is used 
then bit 13 of the first word of the wait 
instruction is set . 



EXAMPLE(S) 



10 LET CHANNEL: -5 

20 DB AA,3 

30 LET AA(0):«!200 

40 LET AA(1):-100 

50 LET AA(2):-U05 

60 BSIO BB 

70 WR 8, AA(0), 3 

80 WAIT 

90 IN H 

100 RSIO 



.Seek Command 
.Cylinder 100 
.Head 1, Sector 5 

.Issued Seek 

.Wait for Completion 

.Done 

.Start Channel Program 
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914 WB 

OPERATIOH NAME: Write Burst 

MNEMONIC: WB MOD, XX(N), BC[,[BL] [ , [DC-XJ [ , [R] [ , [E]]]]] 

DESCRIPTION: This statement executes the Write Burst channel 
program instruction. The parameters are the same 
as those for RB except the TD is not valid and E 
is added to flag at the end of each burst with 
the HP-IB END message. 



EXAMPLE(S): 



10 LET CHANNEL: «7 

15 DB AA.6 

20 BSIO BB 

30 WB 0,AA(5),1. ,, 

40 

50 

60 IN H 

70 RSIO 

-or- 

10 LET CHANNEL: -2 

20 DB AA,1,0 

30 BSIO BB 

HO WB 31,AA(0),1 

50 IN H 

60 RSIO 



.Begin Channel Program 
.Write One Byte 
.From the Right 
.Byte of AA(5) 
.Done 



.Control byte is 



.Initiate Self test 
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9.15 WDMAB 

OPERATION NAME: Write DMA Burst 

MNEMONIC: WDMAB XX(N). BC [ . [BL] [ , [R] [ ,E] ] ] 



DESCRIPTION: This statement executes the Write DMA Burst 
channel instruction. The parameters are the same 
as those for WB except the modifier and DC are 
deleted. 



9.1« WDMAR 

OPERATION NAME: Write DMA Record 
MNEMONIC: WDMAR XX(N), BC[,R] 



DESCRIPTION: This statement executes the Write DHA Record 
channel program instruction. The parameters are 
the same as WR except the modifier and DC are 
deleted. 



9.17 WR 

OPERATION NAME: Write Record 

MNEMONIC: WRMOD, XX(N), BC [ , [DC»N][, R] ] 

DESCRIPTION: This statement executes the Write Record channel 
program instruction. The parameters are the same 
as those for RR except the TD is not valid. 

EXAMPLE ( S} : 

> 10 WR 0,JJ (0),256,DC=2 .WRITE 4 SECTORS. GET FIRST 

> 20 WR 0,BB{0) ,512,DC=1 . FROM JJ, THE NEXT TWO FROM BB 

, 75 wp t ?F'I??;,2 ,; 6 »MD THE LAST ONE FFOM FFfj.281 
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918 WREC 

OPERATION NAME: 
MNEMONIC : 

DESCRIPTION: 



Write Register 

WREG K, XX(N) 
WREG K, X 

The parameters are the same as those for RREG. 



9.19 WRIM 

OPERATION NAME: Write Relative Immediate 
MNEMONIC: WRIM Z, [X] 



DESCRIPTION: This statement executes the Write Relative Im- 
mediate channel program instruction. Z is the 
displacement from the next instruction of the 
channel program ( -128< -Z< = 127) . X is the data 
to write into the channel program at that loca- 
tion. The constant used is what is already in 
the word at WRIM execution time. 



EXAMPLE(S) : 



> 100 JUMP 110 

> 110 WRIM -3,y 

> 120 JUMP 100 

> 130 IN H 



.Jump to 130 Second Time 
.Change 100 to JUMP 130 
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FUNCTION STATEMENTS | 



I | SECTION I 



I I 



10.8 INTRODUCTION 



This section defines the statements used in creating programmed 
functions . 



101 ENDF 

OPERATION NAME: End Function Definition 

MNEMONIC : ENDF 

DESCRIPTION: This statement terminates a Function definition. 

EXAMPLE(S): See FUNCTION statement . 

10.2 GETNAMEDATA 

OPERATION NAME: Get data found offset from NAME parameter 

MNEMONIC: GETNAMEDATA NAMEx, offset, variable 

DESCRIPTION: Provides access to the memory location offset 
from the pointer found in NAMEx. If a buffer 
was passed as the NAME parameter then the 
element of the buffer plus offset ia stored into 
variable. If a buffer was not passed then an 
AID execution error is reported. 
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EXAMPLE(S): 

10 DB AA.100 



100 FUNCTION DOIT NAME1 

110 GETNAMEDATA NAME1,5,A .Store contents of AA(15) Into A 

120 GETNAMEDATA NAME1,-3,B .Store contents of AA(7) Into B 



200 ENDP 

500 DOIT AA(10) 

10.3 GETANAMEINFO 

OPERATION NAME: Get NAME parameter information 
GETANAMEINFO NAMEx [,X][,Y][,Z] 



MNEMONIC : 
DESCRIPTION 



Provide the identity of the NAME/6 parameter 
including: 

Type- simple variable, reserved variable, data 
or string buffer. 

Name- A through Z or position of reserved vari- 
able in AID Reserved Variable Table. 

Element- number of the buffer element passed. 

Length- Size of the buffer in words . 

X, if included, is stored with the following 

information: 



1 
type 



8 
name 



15 



type«0 for data buffers (AA-ZZ) 

1 for string buffers (&AA-4ZZ) 

2 for reserved variables (MAXMEM0RY-VALUE8 ) 

3 for simple variables (A-Z) 

name-%101 for A,AA or &AA through *132 for Z , ZZ or &ZZ. 
If type is a reserved variable then name equals 
the offset from the first reserved variable in 
memory (See AID LIST R Command for their order). 
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Note: If a NAME parameter is not passed, then X is 
defaulted to that name parameters Reserved 
Variable. 

Y, if included, is stored with the element passed 
if the NAME parameter was a buffer else -1. 

Z, if included, is stored with the length of the 

buffer passed in NAMEx. If a buffer wasn't passed then Z is 
stored with -1. 

EXAMPLE(S): 

10 DB AA.100 



100 FUNCTION EXAMPLE NAME1 .NAME2.NAME3 ,NAMEU 

110 GETNAMEINFO NAMEl.A.B.C .A»*101( ID) ,B=5(element ) ,C=100 

( length ) 
120 GETNAMEINFO NAME2,D,E,F .D=0(default parameter) ,E-F»-1 
130 GETNAMEINFO NAME3,G.H,I .G**1«0132(ID) ,H«I— 1 
110 GETNAMEINFO NAME«,J,K,L . J=-*100005( 5th Reserved Variable), 

K=L=-1 



500 EXAMPLE AA(5),,Z,STEP .See FUNCTION EXAMPLE 



10.4 FUNCTION 

OPERATION NAME: 
MNEMONIC : 



Function Declaration 
FUNCTION name [parameters] 



DESCRIPTION: Defines the entry point and parameter format of 
subsequent function calls. The function capa- 
bility enables the user to create quasi- 
statements with an unique name and parameters 
where : 

name* maximum of 8 alpha characters . 

parameters* Pn [,Pn ,Pn] 

where : 

P« NAME for a variable or buffer 
passed by name. 
VALUE for a constant, variable or 
buffer passed by value. 
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n= ordinal number* of P where 1 is 
the first parameter of the 
NAME or VALUE type and K=n<=6 for 
NAME and 1<=N<=8 for VALUE. 

The following rules** govern FUNCTION use: 

(1) Calls to the FUNCTION Statement must ensure all parameter 
types are matched. Any parameter may be defaulted (i.e., ex- 
cluded) except the NAME type when it is used as a read/write 
buffer (e.g., RR 0,NAME1,5)- Defaulted VALUE parameters are 
assigned the quantity and defaulted NAME parameters are 
assigned to the Reserved Variable bearing their name. 

" Example: VALUE1, VALUE2 , NAME1 , VALUE3.NAME2 , VALUE4 .NAME3.NAMEU 
** See the respective examples on the following pages which 
display rule usage. 

(2) Function calls may not be input unless the appropriate FUNC- 
TION Statement is already in the program. If a FUNCTION 
Statement is deleted, any calls to it render the program unex- 
ecutable and a LISTing of the function calls will yield a 
warning message. 

(3) A FUNCTION calling a FUNCTION is allowed but limited to the 
amount of space available to the user program (i.e., every 
FUNCTION call places a 15 word information block into the 
program area and each ENDF Statement removes just one 
information block). 

(4) The FUNCTION Statement may never be executed in line (i.e., it 
must be called) and a branch into a FUNCTION-ENDF Statement 
sequence during execution will produce an error. 

(5) All AID Statement .Command, Reserved Variable keywords (e.g., 
LET, TEST, etc. ) and the buffer names AA to ZZ are reserved and 
an attempt to input a FUNCTION statement name using such a 
keyword will result in an error. 

Limitations using functions: 

(a) Use of name buffers (i.e., NAME1-NAME6) is not allowed in 
AID Statements that use buffers without elements (e.g., 
BSIO, RSIO, DB, etc). 

(b> Indexing of nMn» buffers is not allowed (1.*., NAMEKX)). 
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Example of RULE 1 ( correct way ) 



> 10 FUNCTION ADDEM NAHE1 , VALUE1 , VALUE2 

> 20 LET NAME1:=VALUE1+VALUE2 

> 30 ENDF 

>100 ADDEM A, 7, 2 .k:=l*Z 
Example of RULE 1 ( incorrect way ) 



> 10 FUNCTION ADDEM NAME 1, VALUE 1 , VALUE2 

> 20 LET NAME1:=VALUE1+VALUE2 

> 30 ENDF 

>100 ADDEM 4,7,2 

>110 RUN 

** AID ERROR in Statement 10 ** 

FUNCTION Parameter invalid or in wrong order 



Example of RULE 2 ( correct way ) 

> 10 FUNCTION GETSR NAME1 

> 20 RSW NAME1 

> 30 LET NAKE1:»NAHE1 AND ! 7P 

> 40 ENDF 



>100 GETSR AA(0) 
>110 

10-5 



AID Diagnostic Language 



Example of RULE 2 ( incorrect way ) 

(Assume this is the first Statement input) 

> 10 GETSR AA(0) 

*" AID Entry Mode Error ** 
Illegal parameter, type or input 

-or- 

> 10 FUNCTION GOING NAME1.NAME2 

> 20 ENDP 

> 30 GOING A,B 

> DO DELETE 10 

> «0 LIST 

20 ENDF 

30 "Undefined FUNCTION call to Statement 10 



> U0 

(Note- Statement 30 is supposed to be GOING A, 3 
but has no significance since Statement 
10 was deleted. Statement 10 must be re- 
stored with a FUNCTION Statement to LIST 
or execute normally.) 

Example of RULE 3 ( correct way ) 

(Demonstrates a FUNCTION calling a FUNCTION) 

> 10 FUNCTION ADDEM NAME1 , VALUE1 , VALUE2 

> 20 LET NAME1:«VALUE1+VALUE2 

> 30 ENDF 

> 40 FUNCTION GETSR NAME1 

> 50 RSW NAME1 

> 60 ADDEM NAME1 , NAME1 , 4 . Add 4 to sw. reg. 

> 70 ENDF 
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>200 GETSR A .Get sw.reg. and add 4 to it 

(Demonstrates a recursive function call) 

> 10 FUNCTION POWER NAME1 , VALUE1 , VALUE2 , NAME2 

> 20 IF VALUEK1 THEN 50 

> 30 LET NAME2:=VALUE2:*NAME1 # VALUE2, VALUE1 : =VALUE1-1 

> 40 POWER NAME1.VALUE1,VALUE2,NAME2 

> 50 ENDF 

>200 POWER A,7,1,B .Get A to 7th power and put in B 

Example of RULE 3 ( incorrect way ) 

> 10 FUNCTION FOREVER NAME1 

> 20 FOREVER NAME1 

> 30 ENDF 

>100 FOREVER A 

>110 RUN 

•• AID ERROR in Statement 20 " 

Data buffer area overflow 



(Statement 20 will build 15 word block until no more 
program space is available at which time the program 
will abort. ) 

Example of Rule U ( correct way ) 

> 10 GOTO 300 Branch around Functions 

> 20 FUNCTION POWER NAME1.VALUE1 



>290 ENDF 
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>300 .Start of normal program 
Example of RULE U ( incorrect way ) 

> 10 FUNCTION POWER NAME1.VALUE1 

> 20 LET NAME1:=NAME1*NAME1 

> 30 ENDF 

> HO RUN 

** AID Execution Mode Error in Statement 10 ** 
FUNCTION cannot be executed in-line 

Example of RULE 5 ( correct way ) 

> 10 FUNCTION TESTX NAME1 . TESTX is valid 

Example of RULE 5 ( incorrect way ) 



> 10 FUNCTION TEST NAME1 



*• aid Entry Mode Error *" 

Invalid FUNCTION name or reserved keyword 

Practical 1/0 application 

>1G0 FUNCTION READDATA VALUE1 ,NAME1 , VALUE2 .NAME2 

>110 .Reads data into buffer NAME1 with modifier VALUE1 

>120 . and length VALUE2 and compares the read 

>130 . data to buffer NAME2 

>1M0 INIT .Intialize Device 

>150 BSIO AA . Build Channel Program 

>160 RR VALUE1.NAME1.VALUE2 .Read record 

>173 RSI0 . Execute Channel Program 

>180 CB NAME1,NAME2,VALUE2 .Compare buffers 
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>190 ENDF .End of READDATA 

>500 READDATA 0,AA(O) , 256 ,BB(0) .Get and test data 

>510 IF INDEX=-1 THEN 550 

>520 EPRINT* "Compare Error! Bad Data*" ;AA(INDEX) ; 

>530 PRINTEX " Good Data=" ;BB( INDEX) 

>5U0 EPAUSE 

>550 .Continue Program 



10.S SETNAMEDATA 



OPERATION NAME: Store data into a NAME buffer element 

MNEMONIC: SETNAMEDATA NAMEx, offset, variable 

DESCRIPTION: Stores the data in variable into the buffer 
element plus offset passed as a NAME parameter. 
If a buffer was not passed an AID execution 
error will occur. 



EXAMPLE(S) : 

10 DB AA.100 



100 FUNCTION DOIT NAME1 

110 SETNAMEDATA NAME1.5.A .Store contents of A into AA(15) 

120 SETNAMEDATA NAME1,-3,B .Store contents of B into AA(7) 



200 ENDF 

300 DOIT AA(10) 
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1.0 INTRODUCTION 

The Sleuth Simulator language simulates the HP 3000 Series II and 
III Sleuth programming language. The purpose of the Sleuth Sim- 
ulator is to provide as many of the HP 3000 Series II/III state- 
ments as possible to a user of an HP 3000 HP-IB version computer 
system. 

The simulator is writen in HP AID, a lower level language, and 
AID is written in SPL II. The simulator is actually a series of 
AID functions, which are a series of HP AID statements, and simu- 
late each particular Sleuth statement defined in this manual. 
The simulator will maintain Sleuth's ability to run up to eight 
devices of various types concurrently. 

Note that not all Sleuth commands and statements, as indicated in 
the Sleuth Manual for HP 3000 Series II/III, are included in 
this manual . 

Section IV presents the additional commands that may be used for 
Command Set 80 (CS/80) compatible devices. 

1.1 HARDWARE REQUIREMENTS 

The Sleuth Simulator can run on any HP 3000 HP-IB version com- 
puter system with the following minimum equipment : 

o Memory - Minimum system memory configuration 

o System Console and COLD LOAD device 

12 SOFTWARE REQUIREMENTS 

o Diagnostic Utility System that includes AID and Sleuth 
Simulator. 

o AID and Sleuth Simulator manuals 
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13 SLEl'TH SIMULATOR LIMITATIONS 

The Sleuth Simulator is a separate program written in the HP AID 
language. When you enter a Sleuth program, the Sleuth Simulator 
becomes a part of this program. With the Simulator becoming part 
of a user's program, the variables and word buffers normally 
available to an HP AID user program have been limited as follows: 

Variables A through N are available 

Word Buffers AA through NN are available 

String Buffers &AA through &VV are available 

All Reserved Variables are available 

If you use any of the non-available simulation variables, word 
buffers, or string buffers, an error may be reported or the oper- 
ation of your program could be adversly affected. 

1.4 DISC LIMITATIONS 

The Sleuth default mode for the file mask (13037 controller) in 
the HP 3000 Series II/III is cylinder mode. For HP 3000 HP-IB 
version computer systems it will be "surface mode". This limi- 
tation is created by AID'S inability to distinguish a difference 
between a parameter of zero and an omitted parameter (both appear 
as zero). For example; if the following statement is entered, 

RDI 0,AA(0) ,0 

the simulator will set the file mask to zero. If the last zero 
is not entered at all, AID will still pass the simulator a zero. 
Therefore, the simulator cannot distinguish between an omitted 
parameter and a zero (0). 
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2.0 LOADING SLEUTH SIMULATOR 

The Sleuth Simulator program (written in the AID language) is 
physically located on the Diagnostic Utility System cold load 
media under the f-le name SLEUTHSM. To execute the Sleuth Simu- 
lator program, perform the following procedure: 

1. Cold load the DUS program and press the console RETURN key. 

2. Once the DUS program has output its title message and prompt 
( : ) enter, "AID". 

3. AID will respond with a prompt character (>) and line number: 
>10 

J|. Enter "LOAD SLEUTHSM". The Sleuth Simulator is now loaded 
and you may enter your program statements or commands . 

2J ENTERING A SLEUTH PROGRAM 

The simulator program will occupy lines 0000-1*990, leaving 5000- 
9999 for user program entry. Note that the simulator will become 
part of the program entered. 

13. DELETING A SLEUTH PROGRAM 

The DELETE command must be used to erase lines of code generated 
by your entries. It will erase only the lines specified: 

D(elete) 5000/5100 

To erase both the Sleuth Simulator and your program, use the EP 
command. If this occurs inadvertantly, you can load the 
simulator again by entering "LOAD SLEUTHSM". 

All commands and statement descriptions can be found in Section 
III of this manual. 



2.3 PROCEED MODE 

The Sleuth Simulator does not turn off the proceed mode at any 
time. A user should use this HP AID statement with caution. 
Refer to the HP AID manual for more information on this 
statement . 
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2.4 LISTING PROGRAMS.BITFERS OR VARIABLES 

A copy of the Sleuth Simulator and/or the Users Program may be 
obtained by use of the AID "LIST" command. To list the Sleuth 
Simulator program and the users program enter the following on 
the next available line: 

>6010 L 

To list the Sleuth Simulator program, enter the following on the 
next availably line: 

>6020 L 1/5000 

To list the users program, enter the following on the next 
available line: 

>6010 L 5000/6000 

Variables, AID reserved words, and buffers can be listed by the 
use of the following entries: 

>6010 L V (Lists all variables) 

>6010 L V,C (Lists variable C) 

>6010 L R (Lists all reserved words) 

>6010 L R.PASSCOUNT (Lists the contents of the reserved 

word PASSCOUNT) 
>6010 L B,AA (Lists the entire buffer AA) 
>6010 L !B,AA,1/10 (Lists words 1-10 of buffer AA in 

HEX format) 

Refer to the AID manual for more detailed information on the use 
of the List command. 

2.S PROGRAM EXECUTION 

A user can execute their program by using the AID "RUN" command 
as shown in the following example: 

>6O50 BUMP C 
>6060 NEXT 5020 
>6070 RUN 

A users program can be terminated programmatically with the use 
of the AID "END" command. A user can also stop execution of a 
program, at the console, by entering Control Y. This will place 
them in the AID entry mode. 
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3.0 INTRODUCTION 



The following pages in this section will describe the capabili- 
ties of each simulated sleuth statement. Statements that have 
the same mnemonic as an HP AID statement, command, reserved vari- 
able, or buffer name (AA-NN), that are being simulated, will have 
an S preceeding the original mnemonic (i.e., compare buffer (CB) 
will become (SCB) . 

NOTE 

All buffers and variables must be in upper case. 
The simulator will not recognize lower case letters. 

Functions that differ from the original Sleuth statement will 
either describe the difference or refer to an HP AID equivalent 
statement that will perform that specific task. 

The syntax for each of the following statements defines what the 
parameters of the statement are. If a parameter is optional it 
will be enclosed by brackets (i.e., SEEK lun [, cylinder, head, sec- 
tor] ) . If SEEK 3 is entered in a user program, then a seek for 
logical unit 3 to cylinder 0, head 0, sector would be issued. 
The parameters that are not enclosed by brackets are required 
inputs. If any parameter is not entered, the default for that 
particular parameter is 0. This implies that a SEEK statement, 
by itself, will issue a seek for logical unit 0, to cylinder 0, 
head 0, sector 0. 

The statement descriptions on the following pages are presented 
in alphabetical order. 
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I Statement | Description |Page| 


1 AR I Address Record i 6 j 


| ASSIGN L Assign data to buffer j 7 | 


| BSF I Backspace file | 8 | 


| BSR | Backspace record j 9 j 


I BUMF I Bump Pass Counter | 10 | 


I CHB | Change Buffer 1 11 1 


I CL j Clear disc parameters 1 13 j 


I CLREAD | Cold Load Read 1 12 1 


I CORB I Correct Buffer | 14 | 


| DB I Define Buffer | 15 | 


| DENS I Density I 16 I 


j DEV | Device Definition j 17 | 


I DISP j Display LUN information | 18 | 


j DS I Decremental Seek | 19 j 


I ES 1 Enable Status | 20 | 


j ESTA j Expected Status | 21 1 


j FMT | Format j 22 | 


IFOR-UNTILI For-Step-Until Loop 1 23 1 


I PSF | Forward Space file j 24 | 


j FSR j Forward Space record | 25 | 


I GAP I Write Gap on specified tape unit | 26 | 


j GET I Get logical unit information j 27 1 


I GO I Continue program execution I AID I 


j GOTO I Unconditional program branch | 28 j 



HP AID STATEMENTS 
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[Statement | Description I Page 


1 ID | Initialize data 1 29 


1 IDI | Initialize data immediate I 31 


i IF-THEN | Conditional program branch true j 33 


I IFN-THENJ Conditional program branch false | 34 


1 INPUT | Input data 1 35 


1 IS I Incremental Seek 1 36 


! IT | Increment track 1 37 


1 LET j Assignment of variables | 38 


1 LOOPTO i Conditional Loop Branch | 39 


1 MC | Master Clear | 40 


1 NEXT | End of For-Step-Until-Next loop | 41 


1 PAUSE | No-error Pause I 42 


j PE i Pause on Error ] 43 


I POLL i Resume polling devices | 44 


! PRINT I Print to console without pause | 45 


1 PROC | Proceed without end of Chan Progi 46 


I RAND | Randomize | 47 


] RC | Recalibrate I 48 


1 RD | Read data (Disc) | 49 


1 RD | Read Data (Tape) I 51 


1 RDA I Request Disc Address I 52 


I RDB I Randomize Define Buffer | 53 


j RDI | Read Data Immediate I 54 


I REW | Rewind tape | 56 


1 REWOFF I Rewind Offline I 57 



* HP AID STATEMENTS 
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I Statement I Description IPagel 


I RFS | Read Pull sector | 58 | 


1 RFSI | Read full sector immediate | 59 | 


1 RP | Ripple Print | 60 | 


j RQST J Request status j 61 I 


1 RRB j Read Record Backward j 62 | 
I RS j Random Seek j 63 j 


I RSA 1 Request Sector address | 64 | 


1 RSYN j Request Syndrome | 65 | 


1 RWO | Read with offset | 66 | 


1 RWOI | Read with offset immediate I 68 | 


I RWV | Read without Verify | 69 1 


1 RWVI | Read without Verify immediate 1 71 1 


| SCB 1 Simulated compare buffer | 73 1 


1 SEEK | Seek I 74 1 


1 SELU | Select Unit | 75 1 


I SFM | Set File Mask | 76 | 


1 SKRD I Seek and Read data 1 77 1 


1 SKWD 1 Seek and Write data | 79 | 


j SOUT j Switch output 1 81 1 


j SST j Suppress Status j 82 I 


1 STAT j Status Dump | 83 | 


I TIMEOUT | Channel Program Timeout flag I 8H | 



HP AID STATEMENT 
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Statement | Description IPage 


VER 1 Verify disc 1 85 


VERI 1 Verify disc immediate 1 86 


WD I Write Data (Disc) i 87 


WD 1 Write Data (LP) 1 89 


WD I Write Data (Tape) 1 91 


WDI I Write Data Immediate 1 92 


WFM i Write File Mark 1 93 


WFS I Write Full Sector 1 9f 


WFSI I Write Full Sector Immediate j 95 



3.2 COMMANDS (AID/SLEUTH) 

Refer to the AID Manual for commands , as all AID commands are 
valid for Sleuth programs. 



3.3 STATEMENTS 

General Statements control system oriented data manipulation. 
Each statement description contains the formal name, the function 
name or mnemonic, the syntax of the statement, a parameter 
description, a description of the statements operation, and an 
example of the statement usage. 

Statements provided in this manual include both Sleuthsm and some 
common AID statements. AID statements are included for conven- 
ience of the user. Refer to the AID manual for a complete set of 
available AID statements. 
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FORMAL NAME: Address Record 

FUNCTION NAME: AR 

SYNTAX: >AR lun[ , cylinder .head , sector] 

PARAMETERS: lun - Logical unit number. 

cylinder - cylinder address 
head - head address 
sector - sector address 



OPERATION: Sets logical address specified in the cylinder, 
head, and sector parameters into 7910K and 13037 disc 
controllers only, and does not reposition the heads. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 AR 0,H,2,3 
>5020 RDA 
>5030 DISP 0,D 
>5010 RUN 

The above example uses the Address Record function to set the 
logical disc address into the disc controller. The Request Disc 
Address function and the Display function obtain and display the 
address . 
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FORMAL NAME: Assign Data to Buffer 



AID OPERATION NAME: 



ASSIGN data buffer( element )[,( repeat 
factor)] ,datal[ ,data2, , ,datan] 



DESCRIPTION: Stores data into a data buffer. The word datal is 
stored into data buffer (element) and, if included 
data2 is stored in data buffer (element+1) and so 
on through datan which is stored in data buffer 
(elements). If repeat factor is included the data 
pattern is repeated (repeat-factor) times. 
Datal through datan must be numeric . 

EXAMPLE(S): >5000 DB AA,100,%55 .INITIALIZE AA TO X55 
>5010 ASSIGN AA(50),5,10,15,20,25,30,35 

(AA(50)=5. AA(5D=10, . . . AA(56)=35) 

>5010 ASSIGN AA(10),(10), !FF 

(AA(10) THROUGH AA(19))=!FF) 

>5010 ASSIGN AA(80),(5),3,7 

(AA(80)=3, AA(8l)=7, AA(82)=3, AA(83)=7 etc.) 

>5010 LET A:=80,P:=5 
>5020 ASSIGN AA(A),(F),3,7 

(Same as ASSIGN statement 5010 above) 
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BSF 

FORMAL NAME: Backspace File 

FUNCTION NAME: BSF 



SYNTAX : 



>BSF lun 



PARAMETER: lun - Logical unit number 

OPERATION: This function issues a backspace file to a magnetic 
tape unit . 

EXAMPLE: >5000 DEV 1,5,1.10,0 

>5005 FOR B:«0 UNTIL 10 

>5010 GAP 1 

>5020 WFM 1 

>5030 NEXT 5005 

>5035 FOR C:«0 UNTIL 9 

>5040 BSF 1 

>5050 NEXT 5035 

>5060 REW 1 

>5070 RUN 

This example demonstrates how a BSF function might be utilized in 
a user program. Eleven file marks are written on the tape then 
the tape unit is backspaced 10 file marks. 
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BSR 



FORMAL NAME: Backspace Record 

FUNCTION NAME: BSR 

SYNTAX: >BSR lun 

PARAMETER: lun - Logical unit number 



OPERATION: This function will cause the magnetic tape unit 
backspace one record from its present position. 



to 



EXAMPLE: >5000 DEV 0,5,1,10,0 
>5010 RDB AA{0),128 
>5015 FOR C:=l UNTIL 10 
>5O20 WD 0,AA(0) 
>5030 NEXT 5015 
>5035 FOR D:=l UNTIL 9 
>5040 BSR 
>5050 NEXT 5035 
>5060 REW 
>5O70 RUN 

This example writes 10 records (128 words) then backspaces 
through nine of them. 
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BUMP 



FORMAL NAME: Bump Pass Counter 
AID OPERATION NAME: BUMP[;][H] 



DESCRIPTION : 



EXAMPLE(S): 



Increments the Reserved Variable PASSCOUNT (unless 
the H -parameter, which inhibits PASSCOUNT from 
incrementing, is used) and then prints that pass 
count on the Console. The pass counter (Reserved 
Variable PASSCOUNT) is initialized to zero when- 
ever the RUN command is issued. Printing may be 
suppressed by a SNPR command and, if the optional 
semi-colon follows BUMP, no return-line feed will 
be issued after the pass counter value is printed. 



>5000 BUMP H 
>5010 RUN 

System outputs "END OP PASS 0". Note that passcount 
is still after the print because of the H pann. 



>5000 BUMP; 

>5010 PRINT "FOUND A BUG! 

>5020 RUN 



System outputs "END OF PASS 1 FOUND A BUG ! ! ' 
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CHB 



FORMAL NAME: Change Buffer 
FUNCTION NAME: CHB 
SYNTAX: >CHB buf ( 0) , type 



PARAMETERS: buf - Buffer to be changed. 

This parameter must be any buffer AA(0)-NN(0) 
where AA-NN define buffer name and (0) sets 
an HP AID pointer to the first element in. the 
buffer. 

type - Type of change . 

TYPE FUNCTION 



Fill with address 

Randomize 

Increment 

Decrement 

Circular shift left (shifts bits 

within each element 1 place to left) 

Circular word shift (shifts words 

within buffer 1st to last and all else 

moves down one position) 



OPERATION: The CHB command will change the contents of the 
specified buffer. 
NOTE: Buffer manipulation with this function is slow. 

EXAMPLE: 5000 DEV 0,6,1,20,0 
5010 DB AA.1096 

5020 ASSIGN AA(0), (1021), S52525, £125252, %66666,S33333 
5030 DB BB, 4096,0 
5040 FOR C:= 1 UNTIL 100 
5050 FOR I:=0 TO Hi 
5060 WD 0,AA(0),7,I,0,0 
5070 RD 0,BB(0),7,I,0,0 
5080 SCB 0,AA(0),BB(0),5 
5090 NEXT 5040 
5100 CHB AA(0),R 
5110 NEXT 5030 
5120 RUN 

This example uses the CHB function to randomize the data buffer 
AA. It writes the preassigned buffer AA on the first 32 sectors 
of surface (head 0), reads and compares the data. The buffer 
is then randomized and the process is repeated 100 times. 
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CLREAD 

FORMAL NAME: Cold Load Read 



SYNTAX: > CLREAD lun, buf(O) 



PARAMETERS: lun - An HP 7976 Magnetic Tape Drive 

buf - Buffer into which data will be read. This 
parameter must be any buffer (AA(O)-NA(O) 
where AA-NN is the buffer name and specifies 
the beginning position within the buffer where 
data is placed. 

OPERATION: Places the HP 7976 in its HP7070E emulator mode and 
one record is read. The tape must be positioned at 
Beginning-Of-Tape (BOT) and can be either a 1600 or 
6250 BPI. 

NOTE: The purpose of the 7970E emulator mode is to 
allow the HP 7976 to be a cold-load device on 
HP systems designed to load from an HP 7970E. 



EXAMPLE: >5000 DEV 0,5,1.10,0,6250 
>5010 RDB AA(0),H096 
>5020 DB BB, 4096,0 
>5030 WD 0,AA(0) 
>50M0 REW 
>5050 CLREAD 0,BB{0) 
>5060 SCB 0,AA(0) ,BB(0) 
>5070 REW 
>5O80 RUN 
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FORMAL NAME: Clear 

FUNCTION NAME: CL 

SYNTAX: >CL lun 

PARAMETER: lun - Logical unit number. 

OPERATION: The clear function pertains to disc drives only. It 
will clear any clock offset, clear status, clear the 
interface busy bit and wait for a new command. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 CL 
>5020 RUN 

The above example issues a clear to a disc connected to channel 
6, device 1. 
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CORB 



FORMAL NAME: Correct Buffer 
FUNCTION NAME: CORB 

SYNTAX: >CORB lun.buf(x) 



PARAMETERS: 



lun - 



buf(x) 



Logical unit number; must be 
using the HP 13037 controller. 



HP Disc 



Buffer to be corrected. This parameter 
must be any buffer AA(x)NN(x) where AA-NN 
define buffer name and (x) sets an HP AID 
pointer to the element in the buffer speci- 
fied by the user. 



OPERATION: This statement will correct the data buffer specified 
by the buf parameter according to the last syndrome 
requested for the logical unit designated. 

EXAMPLE: >5000 DEV 0,6,2,10,0 

>5010 DB AA,6lUU,%66666 

>5020 DB BB,6Wi|,0 

>5030 FOR A:= TO 822 

>5010 SEEK 0,A,1,0 

>5050 WDI 0,AA(0) (Note disc is in surface 

mode) 

>5060 RD 0,BB(0),1,A,1,0 

>5070 IF SS(0)=*7U00 THEN 5110 

(disc status word 1 and 
2 is stored in SS(0) and 
SS(1)> 

>5080 SCB 0,AA(0),BB(0),5 

>5090 NEXT 5030 

>5100 END 

>5110 RSYN 

>5120 CORB 0,BB(0) 

>5130 GOTO 5090 

>5140 RUN 

This program writes one track of data on surface 1, reads and 
checks for possible correctable errors and then compares buffers . 
If a possible correctable data error occurs, the data buffer (BB) 
will be corrected if the request syndrome (RSYN) indicates that 
the data is correctable. 
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FORMAL NAME: Define Buffer 

AID OPERATION NAME: DB Name, Length [.assignment data] 

DESCRIPTION: Declares a buffer with a two (alpha) character 
name (AA, BB, . . .NN) and a buffer length up to the 
allowable space available* (see MAXMEMORY under 
Reserved Variables). The parameter length is 
interpreted as a numeric (0 will delete the 
buffer). The only assignment (data) allowed at 
declaration is a string assignment for string buf- 
fers (see example) or numeric or variable for data 
buffers, where the entire buffer is stored with 
that string, numeric, or variable value. Dynamic 
allocation of buffers is allowed, but may cause 
large overhead in execution time since existing 
buffers are "packed" to allow room for a new 
buffer. Dynamic allocation will leave existing 
element values unchanged. 



EXAMPLE(S): 



>5000 DB AA.100 (Declares the buffer AA as 100 words 
long) 



>5000 DB &AA,10 (Declares the string buffer 8.AA as 
10 bytes long (note AA and &AA are 
separate buffers)) 

>5000 DB iCC, 100, "START" (Each sequential 5 byte set 

of &CC contains the 5 ASCII 
characters "START") 

>5000 DB CC, 100,0 (Stores in all 100 elements of 
CC) 

>5000 DB CC.110 (Reallocates CC to 110 words, first 
100 elements remain intact) 

>5000 DB CC.O (Deletes buffer CC) 

NOTE 

Unless you want to clear a buffer by re-defining 
it again, do not include this command inside 
LOOP construct statements. Once it has been 
executed the first time the program is run, 
it would consume time for no purpose relevant 
to the LOOP. 

The limit depends on the ammount of memory taken up by Sleuthsm 
and the users program. At present Sleuthsm provides a user 
with 12. 8K of memory. 
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DENS 



FORMAL NAME: Density 

FUNCTION NAME: DENS 

SYNTAX: lun, DENS 

PARAMETERS : lun - Logical unit number (0 to 7 ) . 

DENS - Tape density (1600 or 6250 bits/inch). 

The density statement allows the user to change the 
tape density on a 7976 Magnetic Tape Drive only. In 
order to change the density the unit must be on-line 
and at the beginning of tape (BOT). The density will 
be set in the unit after a write has been issued. If 
this command is issued and it is followed by any mag 
tape command, other than a write, the unit will 
default to the tape density and ignore the sleuthsm 
density request. 



OPERATION: 



EXAMPLE: 



5,1,10,0 (Dev will set density at 6250) 
1024,7.522525 




>5000 DEV 1 

>5010 DB AA 

>5020 DB BB, 102H 

>5030 DENS 1,1600 

>50U0 WD 1, AA(0) 

>5050 REW 1 

>5060 RD 1,BB(0) 

>5070 REW 1 

>5080 SCB 1, AA(0),BB(0), 5 

>5090 RUN 

This example sets the 7976 Mag Tape density to 1600 BPI, 
and reads a ablock of data and compares the results. 



write 
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DEV 



FORMAL NAME: Device 

FUNCTION NAME: DEV 

SYNTAX: >DEV lun, chan.dev, errs, unit , 1MB 

PARAMETERS: lun - Logical unit number (0 to 7)- 

chan - Channel number device connected to (0 to 15)- 

dev - HP-IB device number (1 to 7). 

errs - Maximum error count the device is allowed 
(1 to 999). 

unit - Device unit number (0 to 7)- 

1MB - InterModule Bus number that the channel is 
connected to. Will normally be zero (0) unless the 
system is a Series 6«. Possible 1MB numbers on 
this system are thru 2. 



OPERATION : 



The Device statement allows the user to define the 
characteristics of a particular device and to assign 
an error count and logical unit number to that de 
vice This function will test for boundaries on all 
parameters, see if the entered channel and device are 
present, identify the device, obtain the device type 
for the 79XX discs (13037 controlled) and store these 
parameters in buffer ZZ for future use. The DEV 
function buffer (ZZ) is structured as described in 
Appendix A. If any of these parameters exceed the 
boundaries or if a non-existent channel or device has 
been entered an error message is output to the con 
sole and the program ends . 



EXAMPLE: >5000 DEV 1,7,2,10,0 
-0R- 
>5000 DEV 0,6,1,25,3 

NOTE 

Do not include this command inside LOOP construct 
statement's. Once it has been executed, the first 
time the program is run, it would consume time for 
no purpose . 
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DBF 



FORMAL NAME: Display 

FUNCTION NAME: DISP 

SYNTAX: >DISP lun, type 

PARAMETERS: lun - Logical unit number, 
type function 



Disc Address 
Requested Status 
Sector Address 
Last Syndrome 



OPERATION: This function will display the item specified in the 
type parameter for the lun indicated. 

EXAMPLE: >5000 DEV 1,6,2,10,0 (7920 disc) 
>5010 RS 1 
>5020 RQST 1 
>5030 DISP 1,R 
>5010 RUN 

the 8 ll°JuT ^ll 1 i ^ US a , rand ° m Seek t0 a 7920A disc - request 
console S6ek com P letes and P^int the status on the 
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DS 



FORMAL NAME: Decremental Seek 

FUNCTION NAME: DS 

SYNTAX: >DS lun[ , cylinder .head , sector] 

PARAMETERS: lun - Logical unit number. 

cylinder - cylinder address 
head - head address 
sector - sector address 



This function will do an initial seek to the location 
specified by the cylinder, head, sector parameters, 
default is 0,0,0. Each time the instruction is exe- 
cuted the cylinder will be decremented by 1 until it 
reaches cylinder 0. When this occurs the disc will 
seek to the maximum cylinder. This function updates 
the internal disc address. 

NOTE 

This function only operates on 7910K and 
13037 disc controllers. 

This function does not decrement a common cylinder 
table. It sets up a cylinder table based on the 
statement number making this function call. Every- 
time that statement # makes a call to this function 
it will decrement its unique table. NOTE: When us- 
ing this function remember that all read, write, and 
verify operations update the 79O6/20/25A discs inter- 
nal address. If a write operation of 128 words 
started at cylinder 100,0,0 and you issued a read 
command following it, the read would begin at cylin- 
der 100,0,1 If a decremental seek was issued before 
the write operation, another decremental seek would 
be issued before the read to properly position the 
heads . 

The maximum number of DS function calls (separate 
entries) allowed for each program is ten (10). 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 DS 0,822,0,0 
>5020 GOTO 5010 
>5030 RUN 
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FORMAL NAME: Enable Status 



FUNCTION NAME: ES 



SYNTAX: >ES 



OPERATION: Enable Status will enable automatic checking of de- 
vice status when utilizing Sleuth simulated state- 
ments (HP AID Functions). 

NOTE 

Enable status is an automatic default function 
of Sleuthsre and therefore, need only be used 
if a Supress Status (SST) command had previously 
been issued. 

EXAMPLE: >5000 DEV 0,6,1,15,2 
>5005 RDB AA(0),128 
>5010 DB BB, 128,0 
>5015 FOR A:= TO 99 
>5018 FOR B:= TO 822 
>5020 TO 0,AA(0) ,1, A, 0,63 
>506O IFN B=822 THEN 5080 
>5070 SST (suppress status) 

>5080 RD 0,BB(0),1,A,0,63 
>5090 SCB 0,AA(0) ,BB(0) ,f 
>5100 DB BB, 128,0 (zero out buffer BB) 
>5110 ES 
>5120 NEXT 5015 
>5130 NEXT 5018 
>RUN 

This example will test the last sector (63) on surface zero for a 
7925A disc. The disc file mask (1) is set (line 5020) to allow 
the unit to increment beyond the end of cylinder. A test is made 
for cylinder 822. When cylinder 822 is reached, the status is 
suppressed for the read operation. This is required to prevent a 
seek check status error that will occur because of the buffering 
scheme of the 12745A disc interface. Refer to the RDA function 
for further information. Status checking is then enabled and 
this process is repeated for 99 more times. 
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ESTA 

FORMAL NAME: Expected Status 



FUNCTION NAME: ESTA 

SYNTAX: >ESTA [ statusl [, mask [, status2 [, mask [, status3 [, mask] ] ] 

PARAMETERS: statusl - First status word for discs, line printers 
or first two bytes of status for Mag Tape. 

mask - A word of don't care bits. A 1 in the mask 
corresponds to a don't care bit in the 
status . 

status2 - Second status word for discs or third byte 
of status for Mag Tape. Mag Tape status 
byte is left justified (bits 0-7). 

status3,mask - Similar to above except for HP 7976 
only. 

NOTE 

If either the status or "mask" parameters 

are omitted, the omitted parameter will be zero 

OPERATION: This statement changes the expected status of the 
next statement which utilizes status checking. 

EXAMPLE: >5000 DEV 2,6,2,10,0 

>5010 ESTA 11300, , 18601, 16100 
>5020 SEEK 2,150,3,0 
>5030 GOTO 5010 
>50KO RUN 

In this example a 7925A disc will continue to seek to cylinder 
150, head 3, sector 0. The expected status is set for a status 2 
error of seek check. If the seek actually completes, then the 
following message will appear on the console: 



79XX DISC STATUS WORD 1 



WORD 2 



STATUS IS 11111 0000 0000 / 00 0011 000000000 
SHOULD BE 10011 0000 0000 / 1 XX 0011 X00000100 



CYLINDER 



0, SECTOR = 0, HEAD = 
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FORMAL NAME: Format 

FUNCTION NAME: FMT 

SYNTAX: >FMT lun, DTRACKS 

PARAMETER: lun - Logical unit number. 

DTRACKS - No. of tracks that have been flagged defec- 
ive (7902 only) 

OPERATION: This function will format a moving head disc !HP 
7902, 7905, 7906, 7910K, 7920 & 7925). It will also 
verify each track . 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 FMT 
>5020 RUN 

When the program begins execution the following is output to the 
console 

•Begin Format 

End Format 

End of AID user program 

* For a 7902 disc, the message "Begin Verifying Formatted Disc" 
will also appear on the console. 
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FOR -STEP- IN TIL 



FORMAL NAME: For-Step-Until 



AID OPERATION NAME: 



F[OR] exp [STEP exp] UNTIL(or TO) 
terminator exp 



DESCRIPTION: 



means of repeating a group 



EXAMPLE(S): 



of 
a 
a 

buffer ele- 
incre- 
of 1. 



Provides a 

instructions between the FOR statement and 
subsequent NEXT statement using a variable as 
counter (the variable cannot be a 
ment). The STEP parameter is an optional 
ment of the FOR variable with a default 
The FOR-NEXT sequence is repeated until termina- 
tor expression value is exceeded by the FOR var- 
iable value. FOR statements may be nested. Note 
that no execution occurs in the FOR statement 
after the initial execution. Note also that 
UNTIL or TO may precede the terminator expres- 
sion but UNTIL will always be listed. 

>5000 FOR I: =5 TO 50 

I 
>5060 NEXT 5000 

This for statement will execute the statements 
between 5000 and 5060 (16 times) with 1=5 
through 50 stepping one at a time. 

>5000 FOR I: =5 STEP 8 UNTIL 50 

I 
>5060 NEXT 5000 

This FOR statement will execute the statement 
between 5000 and 5060 (6 times) with 1=5,13, 
21, 29. 37, H5. 

>5000 for i:=5 step B:=8 until C:=50 

I 
>5060 NEXT 5000 

This statement sequence provides the same se- 
quence of the above statments. 

>5000 FOR AA(2):=-5 TO 50 

I 
>5O60 NEXT 5000 

Buffer element AA(2) will step -5,-4,-3,-2,-1, 
0,1 50. 

*If the STEP value is negative the sequence will repeat until the 
FOR value is less then the UNTIL value. 
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FSF 



FORMAL NAME: Forward Space File 



FUNCTION NAME: FSF 



SYNTAX: >FSF lun 



PARAMETER: lun - Logical unit number 



OPERATION: This function will move the tape forward to the next 
file on the tape. 

EXAMPLE: >5000 DEV 0,5,1,15.0 
>5010 RDB AA(0). 1)000 
>5015 FOR C:=0 UNTIL 10 
>5020 WD 0,AA(0) 
>5030 WFM 
>50U0 NEXT 5015 
>5050 REM 

>5055 FOR D:=0 UNTIL 9 
>5O60 FSF 
>50T0 NEXT 5055 
>5080 RUN 

This example writes 11 records of random data with a file mark 
after each, rewinds the tape, then forward spaces through 10 of 
them. 
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FSR 



FORMAL NAME: Forward Space Record 

FUNCTION NAME: FSR 

SYNTAX: >FSR lun 

PARAMETER: lun - Logical unit number 

OPERATION: This function will move the tape forward one record. 



EXAMPLE: >5000 DEV 0,5,1,15,2 
>5010 RDB AA(0),8000 
>5015 FOR C:=l UNTIL 10 
>5020 WD 0,AA(0) 
>5030 NEXT 5015 
>50»I0 REW 

>501)5 FOR D:=l UNTIL 8 
>5050 FSR 
>5060 NEXT 5045 
>5070 REW 
>5080 RUN 

This example writes 11 records of random data on 
the tape, then forward spaces through 9 of them. 



tape, rewinds 
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GAP 

FORMAL NAME: Gap 

FUNCTION NAME: GAP 

SYNTAX: >GAP lun 

PARAMETER: lun - Logical unit number 

OPERATION: This function Kill write a gap on the specified 
magnetic tape unit . 

EXAMPLE: >5000 DEV 1,5,1.20.2 
>5010 GAP 1 

>5015 REW l 

>5020 RUN 
This example erases a 3 inch portion of mag tape and rewinds. 
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GET 



FORMAL NAME: Get (Used to obtain logical unit information only) 

FUNCTION NAME: GET 

SYNTAX: >Get lun.C or D or E or U or I 



PARAMETERS: lun - Logical unit number. 

C = Channel number 

D - Device number 

E = Error count 

U = Unit number 

I = 1MB number 



OPERATION: 



EXAMPLE : 



This statement will read from the console these 
parameters only. The HP AID statement (INPUT) pro- 
vides the standard capability of receiving operator 
input from the console. 

NOTE: AID statement INPUT can be interspersed with 
Sleuth Simulator statements as with most AID 
statements . 

>5000 PRINT "ENTER THE CHANNEL NUMBER" 

>5010 GET 0,C 

>5020 PRINT "NUMBER OF ERRORS?" 

>5030 GET 0,E 

>50t0 PRINT "NUMBER OF PASSES?" 

>5050 INPUT A 

>5060 FOR I:=l TO A 

>5070 PRINT "PASS NUMBER" ;I 

>5080 NEXT 5060 

>5090 RUN 

ENTER THE CHANNEL NUMBER 
?5 

NUMBER OF ERRORS? 
?10 

NUMBER OF PASSES 
?2 

PASS NUMBER 1 
PASS NUMBER 2 

END OF AID USER PROGRAM 
This example of Get is used to dynamically obtain information 
from the operator. Note that the operator input is underlined. 
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GOTO 



sass 



FORMAL NAME: GO TO (Unconditional branch) 

AID OPERATION NAME: GOTO Statement Number 

DESCRIPTION: Allows the program to branch unconditionally to 
another statement number. 

EXAMPLE: >5060 GOTO 5010 

The above statement transfers control to statement 5010 
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ID 



FORMAL NAME: 



Initialize Data 



FUNCTION NAME: ID 

SYNTAX: >ID lun , buf( )[ ,mask [, fiag[ , cylinder ,head , sector ]] ] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer from which data is read, then written 
to disc. This parameter must be any buffer, 
AA(0)-NN(0) .where AA-NN define buffer name and 
(0) sets an HP AID pointer to the first 
element in the buffer. 

Note: For 7902 discs, buffer size should not exceed one 
sector (128 words). 



Disc parameters indicating starting location 
of initialization operation. The heads are 
assumed to be positioned over the correct 
cylinder, and will not be repositioned by 
these parameters . 

Flags the track as : 
S - Spare 
P - Protected 
D - Defective 
N - Non-flagged 

mask - Loads file mask on the 13037 controller only. 
The mask bits are: 



cylinder 

head 

sector 



flag 



Bits 
12 



13 

1*1 



Function 

Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 

Allow sparing 

Cylinder/surface mode. If set, a 
cylinder consists of all available sur- 
faces; End-of-Cylinder is set when the 
last sector of the last surface has been 
transferred. In surface mode, End-of- 
Cylinder is set when the last sector of 
any surface has been transferred. 
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BITS FUNCTION 



15 



Allow incremental/decremental seek. 



Default mask is surface mode. Default flag is non-flagged, 
fault cylinder, head and sector is 0,0,0. 



De- 



OPERATION: Initialize Data function will perform an initialize 
operation on all 79XX disc drives. The initialize 
operation will begin at the cylinder, head and sector 
designated and will continue until the word count of 
the buffer is exhausted. The designation of the cy- 
linder, head and sector parameters will be accom- 
plished in this function by an Address Record command 
to the 7910K and 13037 disc controller and a seek for 
the 7902 controller. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 DB AA,6l«H,0 
>5020 SEEK 0,10,0,0 
>5030 ID 0,AA(O),3,D,8l5,O,0 
>50H0 SEEK 0,815,0,0 
>5050 ID 0,AA(0),3.S,10,0,0 
>5060 SEEK 0,10.0,0 
>5070 RDI 0,AA(0),7 
>5080 GOTO 5060 
>5090 RUN 

In this example a 7920A disc will seek to cylinder 10, head 0, 
sector 0, flag the entire track defective and place the address 
for its spare in the address field of each sector. It will then 
seek to a spare track (815) and flag it as a spare and write the 
address of the defective track in its address field. A loop is 
then set up to test the sparing feature. 

NOTE: A 7902 disc drive does not have spare tracks but a defec- 
tive track can be made invisible to the controller by flagging it 
defective and formatting the diskette. This process reduces the 
total number of available tracks on that surface. 
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IDI 



FORMAL NAME: Initialize Data Immediate 



FUNCTION NAME: IDI 



SYNTAX: >IDI lun,buf (0) [ ,mask[ , f lag] ] 



PARAMETERS: lun - Logical unit number 

buf - Buffer from which data is read, then written 

to disc . length determines word count of the 
write. This parameter must be any buffer 
AA(0)-NN<0) where AA-NN define buffer name and 
(0) sets an HP AID pointer to first element 
in the buffer. 

Notes :1. For 7902 discs, buffer size should not exceed 
one sector (128 words). 

2. Multiple sector transfers on a 7910 disc 
should not cross a track boundary. Flag one 
track at a time. 

flag - Flags the track as: 
S - Spare 
P - Protected 
D - Defective 
N - Non-flagged 



mask 



Loads file mask on the 13037 controller only. 
The mask bits are: 



BITS 
12 



FUNCTION 

Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 



13 
14 



Allow sparing 

Cylinder/surface mode. If set, a 
cylinder consists of all available sur- 
faces; End-of -Cylinder is set when the 
last sector of the last surface has been 
transferred. In surface mode, End-of - 
Cylinder is set when the last sector of 
any surface has been transferred. 
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BITS 



FUNCTION 



15 



Allow incremental/decremental seek. 



Default flag is non-flagged. Default cylinder, head, sector is 

0,0,0. Default mask is surface mode. 

OPERATION: This function will perform an initialize operation 
on a moving head disc. The internal disc address 
will be used as the starting point of the write. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 DB AA, 6141,0 
>5020 FOR C:=0 UNTIL U10 
>5030 IS 
>50U0 IDI 0.AA(0) 
>5050 IS 0,0,1,0 
>5060 IDI 0,AA(0) 
>5070 NEXT 5020 
>5080 RUN 

The above example formats the upper cartridge on a HP7906A disc. 
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IF THEN 



FORMAL NAME: If -Then Control 



AID OPERATION NAME: 



DESCRIPTION: 



IF exp [ I SPECIAL OPERATOR exp] [SPECIAL 
OPERATOR exp] ] THEN statement number 



Allows the executing program to evaluate "exp" and 
if it is true (non-zero)* to transfer control to 
the statement number specified. "Exp" may be a 
simple variable, data buffer element, assignment or 
expression. Expressions may be seperated by a 
special relational operator not allowed in any 
other expression. The allowable special operators 
are: 

GT (greater than) 

LT (less than) 

GE (greater than or equal to) 

LE (less than or equal to) 

NE (not equal to) 

EQ (equal to) 

Each expression is evaluated and then tested (left 
to right) with the special operator. The result(s) 
of the special operator evaluation(s) is logically 
ANDed and if the overall result is true, control is 
transferred to the THEN statement. Op to three 
expressions are allowed. 

EXAMPLE(S): >5000 IF AA(2) THEN 5050 (If AA(2) is true 

, non-zero, go to 5050) 

>5000 IF A OR B THEN 5030 (The expression "A or B" 

is evaluated) 

>5000 IF 1H LE A:=A+1 LE 20 THEN 5020 

(Test if A+l is between 14 
and 20 INCLUSIVE) 

>5000 IF A:=A+1 GE B:=B+1 GE C:=C+1 THEN 5200 

(Test IF <A+1)>=(B+1)>=(C+1)) 

>5000 IF 1 LT B LT 100 THEN 5020 

.TEST IF B IS BETWEEN 1 AND 100**. 

* See IFN Statement for the reverse branch condition. 

**Note that statement 5000 would not execute the same as IF 

1<B<100 THEN 5020 which executes as "IF(KB)<100 THEN 5020" 

where the result of 1<B will be -1 or 0. 
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IFNTHEN 

FORMAL NAME: IF-NOT-THEN 

AID OPERATION NAME: IFN exp THEN statement 

DESCRIPTION: Identical to the IF-THEN statement (see IF-THEN) 
except the expression "exp" is tested for fal- 
sity in determining if control is passed to the 
label "statement". The expression value is not 
altered by the NOT function. 

EXAMPLE(S): >5000 IF 1 LE A LE 14 THEN 5020 

(If A is between 1 and 14 
go to 5020) 

>5000 IFN 1 LE A LE 14 THEN 5020 

(If A is "NOT" between 1 
and 14 go to 5020) 

>5000 IF A THEN 5020 (If A<>0 go to 5020) 

>5000 IFN A THEN 5020 (If A=0 go to 5020) 
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INPUT 



FORMAL NAME: Input Data 

AID OPERATION NAME: INPUT x,[yL 
I x,[y] , . . [n] 



. [n] 



DESCRIPTION: Provides capability of receiving operator input 
from the Console and assigning that input to a var- 
iable^) . x may be a simple variable, buffer ele- 
ment, string buffer or Reserved Variable. When 
executing, input prompts with a ? or ?? to signify 
an input is expected (see Special Characters). 
Each input value must be separated by a comma. See 
the Reserved Variable INPUTLEN for determining the 
character length of the input . 

EXAMPLE(S): >5000 INPUT A (value input from console is 

interpreted and then stored in A) 

>5000 INPUT AA(2) 
(the console input will be stored in AA(2)) 

>5000 INPUT &BB(2,6) 
(5 characters are accepted from console and stored 
in string buffer BB starting at element 2 - string 
buffers must be used to contain ASCII characters) 

>5000 INPUT A,B,C 
(3 numeric values, separated by commas are 
accepted from the console and stored in variables 
A, B, and C respectively) 

>5000 INPUT A 
(1 numeric value is accepted from the console) 

NOTE- If you fail to enter the correct amount of input parameters 
at the console, the INPUT function will output a double ?? until 
all parameters, called for by the INPUT statement, have been 
entered . 
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FORMAL NAME: Incremental Seek 

FUNCTION NAME: IS 

SYNTAX: >IS lun[ , cylinder, head , sector] 

PARAMETERS: lun - Logical unit number 

cylinder - cylinder address 
head - head address 



sector 



sector address 



OPERATION: This function will do an initial seek to the address 
specified in the cylinder, head and sector para- 
meters. Each time this command is executed it will 
increment the cylinder address. This function up- 
dates the internal disc address. Default cylinder, 
head and sector is 0,0,0. 

NOTE: This function is only valid when used for 

operations on 7910K and 13037 disc controllers 

This function does not increment a common cylinder 
table. It sets up a cylinder table based on the 
statment number making this function call. Only ten 
(10) IS function calls are allowed per program. 

NOTE: All read, write, and verify operations update 
the 79O6/20/25A disc internal address. Multiple use 
of this function can be used to position the 
7906/20/25A discs before write and read operations. 
See example for the IT function for more information. 

EXAMPLE: >5000 DEV 0,6,1,15,0 

>5010 FOR D:=l UNTIL 2000 

>5020 IS 

>5030 NEXT 5010 

>50140 RUN 

The above example causes a moving head disc to execute one cylin- 
der incremental seeks . 
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FORMAL NAME: Increment Track 

FUNCTION NAME: IT 

SYNTAX: >IT lun [, cylinder , head , sector] 

PARAMETERS: lun - Logical unit number 

cylinder - cylinder address 
head - head address 



sector 



sector address 



OPERATION: This function will do an initial seek to the location 
specified in the cylinder, head and sector para- 
meters. It will increment the head address by one 
each time this function is called. After the last 
head has been selected the next increment will pro- 
ceed to the next cylinder. If the cylinder equals 
the last cylinder in the disc the function will seek 
to and start over. This function updates the 
internal disc address. 

This function is only valid when used in operations 
on 7910K and 13037 disc controllers. 

This function does not increment a common track 
table. It sets up a track table based on the state- 
ment number making this function call. A maximum of 
ten (10) IT function calls per program are allowed. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5005 DB AA, 611)4 

>5010 ASSIGN AA(0),(1536),%125252,%66666,%33333,%52525 
>5020 DB BB,6l44 
>5O30 FOR D:=l UNTIL 4115 
>5O40 IT 
>5050 WDI 0,AA(0) 
>5O60 DB BB,0 
>5065 IT 
>5070 RDI 0,BB(0),1 
>5080 SCB 0,AA(0),BB(0),5 
>5090 NEXT 5030 
>5100 RUN 

The above example indicates how this function may be used to test 
all surfaces on an HP 7920 disc. The increment track (IT) util- 
izes a separate counter for the write and read operation, thus 
assuring proper position of the heads before each write and read 
operation. 
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FORMAL NAME: Assignment 
AID OPERATION NAME: 



LET 



[LET] variable := Any variable, numeric, 
expression or string. 



DESCRIPTION: Allows assignment to a variable, data buffer or 
string buffer the value of any variable, numeric, 
expression or string. This Sleuthsm command,^ 
unlike Sleuth, requires the use of the colon ":". 

EXAMPLE(S): >5000 LET A: =10 .A IS ASSIGNED THE VALUE 10 

>5000 LET C:=D+E .C IS ASSIGNED THE SUM OF D + E. 
>5000 LET AA(2):=!F .ELEMENT 2 OF THE BUFFER AA IS 
.THE HEXADECIMAL VALUE F. 

>5000 LET A:=C:=H .MULTIPLE VARIABLE ASSIGNMENTS 
>5000 LET A:=U,B:=7 .MULTIPLE EXPRESSION ASSIGNMENT 

ALLOWED . 
>5000 LET AA(4):=B .ELEMENT 4 OF BUFFER AA IS GIVEN 
.THE VALUE OF THE B VARIABLE. 

>5000 LET &AA(5,9):="HELLO" 

.&AA(5,6)=HE, 1AA(7,8)=LL, 
&AA(),10)=00 
>5000 A:=10 .IDENTICAL TO FIRST EXAMPLE 
>5000 LET A:=B<C ,A=-1 if B<C else A=0 

•The LET keyword may be omitted but a subsequent list will dis- 
play it. 
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LOOPTO 

FORMAL NAME: Conditional Loop Branch 

AID OPERATION NAME: LOOPTO label 

DESCRIPTION: Causes a branch to the statement specified in 
label if a LOOP Command was previously issued, 
otherwise no action occurs 



EXAMPLE(S) : 



> 5100 SECTION 1.5200 



> 5200 SECTION 2,5500 



> 5500 LOOPTO 5100 . Go to 5100 if LOOP flag is 
. set. 

The following example shows how to set the LOOP flag: 

>5000 PAUSE (allows loop flag to be set) 
>5010 DEV 0,6,1,10,0 
>5020 



>5050 

>5060 RUN 
:LO0PON (turns on loop flag) 
:GO (program executes) 



3-39 



SLEUTH Simulator Diagnostic Language 



MC 

FORMAL NAME: Master Clear 



FUNCTION NAME: MC 

SYNTAX: >MC lun 

PARAMETER: lun - Logical unit number. 

OPERATION: This function will clear the specified unit by issu- 
ing a device clear. For the 2608A printer, a master clear will 
be sent and for the 2631A printer a clear 1 (device clear with 
parity enable) is issued. 

EXAMPLE: >5000 DEV 11,6,1,10,5 
>5010 SST 

>5020 SEEK H.823 (Create a seek check) 
>5030 ES 

>5010 MC 1 (Clear device and status) 
>5050 SEEK 4 (Seek to zero (0)) 
>5060 GOTO 5010 
>5070 RUN 

This example will continually loop forcing a seek check error on 
a 7920A disc. The status is suppressed during the error condi- 
tion, enabled afterword and cleared out by the master clear (MC). 
The heads are then repositioned to cylinder 0, head 0, sector 0. 

NOTE: Recalibrate will not work in place of the seek in line 
5050 because the disc address (cyl. 823) is beyond the maximum 
limit. 
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NEXT 



FORMAL NAME: End of For-Next loop 
AID OPERATION NAME: NEXT X 



DESCRIPTION: 



EXAMPLE(S): 



Specifies the end of a For-Next set of state- 
ments, where x must be the statement number of 
a respective FOR statement (not a variable). 

> 5010 LET J: =5 

> 5020 FOR K:=l UNTIL 20 

> 5030 LET BB(K):=J, J:=J+5 

> 50H0 NEXT 5020 

This set of statements would store BB(1)=5.BB(2)=10, 
BB(20)=100. 
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PAUSE 

FORMAL NAME: Non-Error Pause 

AID OPERATION NAME: PAUSE 

DESCRIPTION: Creates an unconditional pause in the exe- 
cution of the user program. This statement is 
suppressed only by the SNPS command. After a 
prompt character (>) is printed on the console 
the operator may enter any valid command. 

EXAMPLE(S): > 5010 PAUSE 

> 5020 RUN 

> (Enter any valid command) 
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PE 



FORMAL NAME: 



Pause On Error 



FUNCTION NAME: PE 



SYNTAX : 



>PE lun 



PARAMETER: lun - Logical unit number 



OPERATION: This function will notify the user that an error 
has occurred and stop the execution of the users 
program. 

Once the function has been executed it can only be 
defeated by an AID suppress non-error pause command 
(SNPS). Program can also be continued by typing GO. 



EXAMPLE: >5000 DEV 0,6.1,15,0 
>5010 PE 

>5020 FOR C:»l UNTIL HOOO 
>5030 RS 
>5040 NEXT 5020 
>5050 RUN 
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POLL 

FORMAL NAME: Poll 



FUNCTION NAME: POLL 

SYNTAX: >POLL lun 

PARAMETERS: lun - Logical unit number. 

OPERATION: This function causes the HP13037 disc controller to 
resume polling. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 POLL 
>5020 RUN 
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PRINT 



FORMAL NAME: Print to Console without Pause 



AID OPERATION NAME: PR [INT] [string] 



(or ,)] [string] etc. 



DESCRIPTION: Enables data, print spacing* or strings to be 
output to list device. This statement must be 
used to print non- error messages only (see 
EPRINT or PRINTEX for error message reporting) . 
This PRINT will only be suppressed by the SNPR 
command . PRINT strings may be concatenated with 
( ; ) to suppress return- line feed or ( , ) which 
generates a return- linefeed. 



EXAMPLE(S): 



> 5010 PRINT 

> 5020 RUN 
A BC 

DE FGH 



'A";2;"BC","DE";3;"FGH" 



> 5010 DB &AA,10,"ABCDEFG" 

> 5020 PRINT &AA(3,6);2;&AA{0,2) 

> 5030 RUN 
DEFG ABC 

> 5030 



5000 PROC .PERFORM I/O WITHOUT WAIT 

5010 LET CHANNEL: =2 

5020 RSIO AA .START CHANNEL PROGRAM AA 

5030 LET CHANNEL: =3 

5010 RSIO BB .START CHANNEL PROGRAM BB 

5050 PROC N .WAIT HERE FOR I/O TO FINISH 
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PROC 



FORMAL NAME: Proceed 

AID OPERATION NAME: PROC[N] 

DESCRIPTION: This statement is used to enable(or disable when 
the N is added) the proceed mode. AID normally 
waits for each Channel program to interrupt 
before continuing to the statement following the 
RSIO. This normal mode of having I/O with wait 
maybe change to the proceed mode(i.e., I/O 
without wait) by using this state. 



EXAMPLE(S): 



(Assume that AA and BB 
programs) 



are pre-defined Channel 



>5000 PROC .PERFORM I/O WITHOUT WAIT 

>5010 LET CHANNEL: =2 

>5020 RSIO AA .START CHANNEL PROGRAM AA 

>5O30 LET CHANNEL: =3 

>5040 RSIO BB .START CHANNEL PROGRAM BB 

>5050 PROC N .WAIT HERE FOR I/O TO FINISH 
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RAND 



FORMAL NAME: Randomize 



FUNCTION: RAND 



SYNTAX: >RAND var 



PARAMETER: var - A variable designated by a letter A thru N. 



OPERATION: 



This function generates a positive random number 
and places it in the designated variable. 



EXAMPLE: 



>5000 RAND A 
>5010 RAND B 
>5020 RAND C 
>5030 RUN 



This example places a random number in the variables A,B & C. 
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RC 



FORMAL NAME: Recalibrate 



FUNCTION NAME: RC 



SYNTAX: >RC lun 



PARAMETER: lun - Logical unit number. 

OPERATION: This function performs a recalibrate operation on a 
7906/20/25A moving head disc. At the completion of 
this operation the heads are located at cylinder 0. 

EXAMPLE: >5000 DEV 2,6,1,10,0 

>5010 FOR A:=l UNTIL 50 
>5020 SEEK 2,822,0,0 
>5030 RC 2 
>50H0 NEXT 5010 
>5050 RUN 

The above example will seek a HP7920A disc to cylinder 822 then 
recalibrate. This process is repeated fifty times. 
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RDtDISO 



FORMAL NAME: Read Data 

FUNCTION NAME: RD 

SYNTAX: >RD lun.buf(O) [ ,mask[ .cylinder, head, sector] ] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer into which data, from disc, is written. 
This parameter must be any buffer AA(0)-NN(0) 
where AA-NN define buffer name and (0) sets 
an HP AID pointer to the first element in the 
buffer. 

cylinder - starting cylinder address 
head - starting head address 
sector - starting sector address 

mask - Loads file mask on the 13037 controller only. 
The mask bits are: 

BITS FUNCTION 



12 Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 

13 Allow sparing 

14 Cylinder/surface mode. If set, a cylin- 
der consists of all available surfaces; 
End-of -Cylinder is set when the last 
sector of the last surface has been 
transferred. In surface mode, End-of- 
Cylinder is set when the last sector of 
any surface has been transferred. 

15 Allow incremental/decremental seek. 

Mask default is surface mode. For the cylinder, head and sector 
parameter default is 0,0,0. 

OPERATION: This function will perform a read operaton on the LUN 
indicated. For 7906/20/25A discs, it includes a Set 
File Mask command followed by a Seek command to the 
cylinder, head and sector parameters. The 7902 discs 
will just seek to the designated cylinder, head, and 
sector parameters . 
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At the completion of a 7906/20/25A disc read opera- 
tion the internal disc address will be four sectors 
beyond the end of the last read operation. The buf- 
fering scheme of the 12745A interface, which has two 
128 word buffers, reads three sectors worth of infor- 
mation before receiving an end of data from the CPU, 
which terminates the transfer. By the time the 
12715A notifies the 13037A disc controller to stop 
the read, another sector has begun to be read. The 
disc has now read three sectors that were not 
transferred. The internal disc address is updated to 
point to the next sector. If a one sector read at 
cylinder 100, head 0, sector were performed, the 
internal disc address will indicate cylinder 100, 
head 0, sector 1. 



EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 RDB AA(0),6l«t 
>5025 FOR C:=0 UNTIL 822 
>503O DB BB,614H,0 
>5040 WD 0,AA(0), ,C 
>5050 RD 0,BB(0),1,C 
>5060 SCB 0,AA(0),BB(0),1 
>5075 NEXT 5025 
>5080 RUN 

This example writes, reads, and compares buffers of a random data 
pattern on surface zero of a 7920A disc. 
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RD (TAPE) 



FORMAL NAME: Read Data 



FUNCTION NAME: RD 



SYNTAX: >RD lun,buf{0) 



PARAMETER: lun - Logical unit number 

buf - Buffer into which data will be read. 

This parameter must be any buffer AA(O)-NN{0) 
where AA-NN define buffer name and (0) sets 
an HP AID pointer to the first element in the 
buffer. 



OPERATION : 



This function will perform a read 
lun specified. 



operation on the 



EXAMPLE: >5000 DEV 0,5,1,10,1 
>5010 RDB AA(0),M000 
>5020 DB BB, 1000,0 
>5030 WD 0,AA(0) 
>50t0 REW 
>5050 RD 0,BB(0) 
>5060 SCB 0,AA(0),BB(0),3 
>5070 REW 
>5080 RUN 

This example indicates how a read data operation may be performed 
on magnetic tape. This program writes one 4000 word record on 
magnetic tape then reads and checks the data. 
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RDA 



FORMAL NAME: Request Disc Address 
FUNCTION NAME: RDA 
SYNTAX: >RDA lun 



PARAMETER : 



lun - Logical unit number. 



OPERATION: This function will return the current disc address 
stored in the controller. If a data error occurred 
it contains the address of the current sector; if 
not , it contains the address of the next logical sec- 
tor. This function may be used to determine where an 
error occurred during a verify or any other function 
which terminates with a error. The address can be 
displayed on the console with DISP function. 

At the completion of a 7906/20/25A disc read opera- 
tion the internal disc address will be four sectors 
beyond the end of the last read operation. The buf- 
fering scheme of the 12715A interface, which has two 
128 word buffers, reads three sectors worth of infor- 
mation before receiving an end of data from the CPU, 
which terminates the transfer. By the time the 
12715A notifies the 13037A disc controller to stop 
the read, another sector has begun to be read. The 
disc has now read three sectors that were not 
transferred. The internal disc address is updated to 
point to the next sector. If a one sector read at 
cylinder 100, head 0, sector were performed, the 
internal disc address will indicate cylinder 100, 
head 0, sector 4. 

EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 RS 

>5020 RDA 

>5030 DISP 0,D 

>50l40 RUN 

This example utilizes the RDA function to obtain the last address 
from a moving head disc. 
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RDB 



FORMAL NAME: Randomize Data Buffer 

FUNCTION NAME: RDB 

SYNTAX: > RDB name , length 

PARAMETERS : name - Two letter buffer name in quotes . 

length - Number of words allocated to buffer. 



OPERATION: This function defines randomized data buffers only. 
Note: The HP AID statements (DB and ASSIGN) should 
be used for string buffers. This function is the 
same as the Sleuth DB statement for randomizing 
buffers . It does not provide the other features of 
the Sleuth DB statement. They can be implemented with 
AID commands. For example: 



FUNCTION 



HP AID FORMAT 



Define a data buffer 
(AA) and fill it with 
minus 1 . 

Define a string buffer 
(BB), 10 elements long 

Define a data buffer 
(CC) with alternating 
data patterns of X33333 
and £66666 for 100 words. 



DB AA, 100,-1 



DB &BB.10 



DB CC.100 

ASSIGN CC(0),(50), 

»33333,»66666 



Note: This function operates slowly (approx. 21 sees 
for 3972 words) due to the overhead required to 
access and modify a buffer. 

EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 RDB "AA"(0),6144 
>5020 FOR D:=0 UNTIL 822 
>5030 SEEK 0,D,2,0 
>5040 WDI 0,AA(0) 
>5050 NEXT 5020 
>5060 RUN 
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RDI 



FORMAL NAME: Read Data Immediate 



FUNCTION NAME: 



RDI 



SYNTAX: >RDI lun.buf ( 0) [ ,mask] 



PARAMETERS: lun - Logical unit number. 

buf - Buffer into which data is 
determines word count of read, 
must be any buffer AA(0)-NN(o; 
define buffer name and (0) 



read . Length 

This parameter 

where AA-NN 

sets an HP AID 



pointer to the first element in the buffer. 



mask 



Loads file mask on the 13037 controller only. 
The mask bits are: 



BITS 



12 



13 

14 



FUNCTION 

Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder 
address will be decremented when End- 
of-Cylinder; otherwise, incremented. 

Allow sparing 

Cylinder/surface mode. If set, a 
cylinder consists of all available 
surfaces; End-of -Cylinder is set when 
the last sector of the last surface 
has been transferred. In surface 
mode, End-of -Cylinder is set when the 
last sector of any surface has been 
transferred . 

15 Allow incremental/decremental seek. 

Default mask is surface mode. 

OPERATION: This function will perform a read operation with 
the internal disc address designating the starting 
point of the read. This function updates the inter- 
nal address. 
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EXAMPLE: >5000 DEV 0,6,1.10,0 

>5010 DB AA, 128,0 

>5020 RDI BB(0),128 

>50ll0 WD 0,BB(0) ,7,120,2,0 

>50»I5 SEEK 0,120,2,0 

>5O50 RDI 0,AA(0),7 

>5060 SCB 0,BB(0),AA(0),3 

>5070 GOTO 5020 

>5080 RUN 

This program writes, reads and compares the continually changing 
data for cylinder 120, head 2, sector 0. 
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REW 



FORMAL NAME: Rewind 



FUNCTION NAME: 



REW 



SYNTAX : 



>REW lun 



PARAMETER: lun - Logical unit number 



OPERATION: This function will issue a rewind command to the 
magnetic tape unit specified. 

EXAMPLE: >5000 DEV 0,5.1.15.0 
>5005 DB &AA.128 

>5010 ASSIGN &AA(0),(32).*123,%377,*3U5.0 
>5015 FOR C:=l UNTIL 10 
>5020 WD 0,&AA(0) 
>5030 NEXT 5015 
>50U0 REW 
>5050 RUN 

This example writes eleven 128-byte records of data then rewinds 
the tape unit with the REW function. 
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REWOFF 

FORMAL NAME: Rewind And Reset 



FUNCTION NAME: REWOFF 

SYNTAX: > REWOFF lun 

PARAMETER: lun - Logical unit number 

OPERATION: This function will rewind and reset the specified 
magnetic tape unit. 

EXAMPLE: >5000 DEV 0,5,1,15.0 
>5010 REWOFF 
>5020 RUN 

This example places mag tape unit offline. 
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RFS 



FORMAL NAME: Read Full Sector 

FUNCTIOK NAME: RFS 

SYNTAX: >RFS lun,buf(0) [ .cylinder, head, sector] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer 
length determines word count of read. This 
parameter must be any buffer AA(0)-NN(0) where 
AA-NN define buffer name and (0) sets an HP 
AID pointer to the first element in the 
buffer. 

cylinder - cylinder address 
head - head address 
sector - sector address 

OPERATION: This function will execute a full sector read opera- 
tion on a 7910K and the 7906/20/25A discs. The heads 
will be positioned over the correct cylinder. The de- 
default cylinder, head, sector is 0,0,0. The length 
of the buffer determines the word count of the read . 



EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 DB AA,138,*52525 

>5015 LET AA(0):=!80FE (SYNC WORD) 

>5020 DB BB, 138,0 

>5030 SEEK 0,123,0,0 

>50J*0 WFS 0,AA(0), 123,0,0 

>5050 RFS 0,BB(0),123,0,0 

>5060 SCB 0,AA(0),BB{0),3 

>5070 RUN 

In this example cylinder 123, head 0, sector has had its 
address field written over by buffer AA. This track should be 
reformatted before proceeding. 
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RFSI 



FORMAL NAME: Read Full Sector Immediate 



FUNCTION NAME: RFSI 



SYNTAX: >RFSI lun,buf(0) 



PARAMETER: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN{0) where AA-NN de- 
fined as buffer name and (0) sets an HP AID 
pointer to the first element in the buffer. 

OPERATION: This function will perform a full sector read opera- 
tion on a 7910K and the 7906/20/25A discs. The length 
of the buffer determines the word count of the read. 
The internal disc address will be used for the start- 
ing point. The internal disc address may be set by 
a Seek or an Address Record command. 



EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 DB AA,138,%125252 

>5015 LET AA(0):=!80FE (SYNC WORD) 

>5020 DB BB, 138,0 

>5050 WFS 0,AA(0),150,1,5 

>5055 SEEK 0,150,1,5 

>5060 RFSI 0,BB(0) 

>5070 SCB 0,AA(0),BB(0) ,5 

>5080 RUN 

This example issues a SEEK (from WFS function) to address 
150, 1, 5 on disc, writes and reads full sectors, then com- 
pares the data. The disc will require formatting after the 
use of the WFSI function. 
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RP 

FORMAL NAME: Ripple Print 



FUNCTION NAME: RF 

SYNTAX: >RP lun, linelength 

PARAMETERS: lun - Logical unit number. 

linelength - Number of columns defining the area 
of ripple print. 

OPERATION: This function will write write a ripple pattern on 
the lun indicated and continue until stopped with 
CNTRL Y or until 32767 lines have been printed. 

EXAMPLE: >5000 DEV 0,7,2,10,0 
>5010 RP 0,132 
>5020 RUN 

This example won If? **esult in a 132 column ripple print on DEV 2. 
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RQST 

FORMAL NAME: Request Status 

FUNCTION NAME: RQST 

SYNTAX: >RQST lun 

PARAMETER: lun - Logical unit number. 

OPERATION: This function will return two words of status from 
the disc controllers (status words 1 & 2). This sta- 
tus may be displayed using the DISP function. The 
status will be stored in buffer SS(0) AND SS(1) for 
any disc function error. This may be useful for user 
programs . 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 SEEK 0,10,0,0 
>5020 RQST 
>5030 DISP 0,R 
>5040 RUN 
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RRB 

FORMAL NAME: Read Record Backward 



FUNCTION NAME; 



RRB 



SYNTAX : 



>RRB lun, buf(O) 



PARAMETER: 



lun - logical unit number 



buf - Buffer into which data will be read. This 
buffer must be any buffer AA(0) - NN(0) 
where AA-NN defines buffer name and (0) sets 
an HP AID pointer to the first element in the 
buffer. 



OPERATION: This function will read from the last element (byte) 
in the record toward the first. The bits within the 
bytes will remain the same if the record is read back- 
ward or forward. 

EXAMPLE: >5000 DEV 0,5,1,5,0 

>5010 DB AA, 1000, %125252 

>5020 FOR C := TO 9 

>5030 DB BB, 1000,0 

>50U0 WD 0, AA(0) 

>5050 RRB 0, BB(0) 

>5060 SCB 0, AA(0), BB(0),lt 

>5070 NEXT 5020 

>5080 RUN 

This program will write one record, read it backwards and compare 
buffer 10 times. 



Note: This function is useful when a record cannot be read 
because of a tape error. The data beyond the error can be 
recovered . 
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RS 

FORMAT NAME: Random Seek 

FUNCTION NAME: RS 

SYNTAX: >RS lun 

PARAMETER: lun - logical unit number. 

OPERATION: This function will cause a moving head disc to seek 
randomly. This function will update the internal 
disc address. 



EXAMPLE: >5000 DEV 1,6,1,15.0 
>5010 RS 
>5020 GOTO 5010 
>5030 RUN 
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RSA 



FORMAL NAME: Request Sector Address 

FUNCTION NAME: RSA 

SYNTAX: >RSA lun 

PARAMETER: lun - Logical unit number. 

OPERATION: This function will return the logical sector address 
of the sector currently under the heads. This 
address may be displayed using the DISP function. 

Note: This function does not apply to 7902 and 7910K 
discs . 

EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 RS 

>5020 RSA 

>5030 DISP 0,S 

>50U0 RUN 

The following messages are output as a result of the above pro- 
gram executing: 

Requested Sector Address for Logical Unit is : 33 

End of AID user program 
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RSYN 

FORMAL NAME: Request Syndrome 

FUNCTION NAME: RSYN 

SYNTAX: >RSYN lun 

PARAMETER: lun - Logical unit number. 

OPERATION: This function will obtain a seven word syndrome from 
the HP13037 (disc controller). A request syndrome 
operation may be issued after any read or verify 
operation which terminates with a possible correct- 
able data error. The seven words of information will 
be read into an internal buffer which may be dis- 
played with the DISP function. The format of the 
syndrome returned is as follows : 

WORD DEFINITION 



1 Status 

2 Cylinder 

3 Head/Sector 

4 Displacement 

5 Pattern 1 

6 Pattern 2 

7 Pattern 3 

EXAMPLE: >5000 DEV 0,6,1,15.0 

>5010 DB AA,6li(il,*133333 

>5020 DB BB,6l4i|,0 

>5030 FOR C:=l UNTIL 5000 

>50UO IT 

>5050 WDI 0,AA(0),2 

>5055 IT 

>5060 RDI 0,BB(0),3 

>5O70 IF SS(0) ■ WOO THEN 5090. (unit # in status word) 

>5O80 NEXT 5030 

>5085 END .Terminates program 

>5090 RSYN 

>5100 DISP 0,Y 

>5 RUN 

NOTE: When attempting to use an entire cylinder on a read opera- 
tion, the controller will attempt to read beyond the end of 
cylinder because of the buffering in the controller. The file 
mask must therefore be set to increment (file mask=l, 3, or 7). 



This example writes and reads data on a HP7920 disc. If a cor- 
rectable data error is detected, the syndrome is requested and 
displayed. 
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RWO 

FORMAL NAME: Read With Offset 



FUNCTION NAME: RWO 



SYNTAX: >RWO lun,buf(0) , mask, offset[ , cylinder, head, sector] 



PARAMETER: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN de- 
fine buffer name and (0) sets an HP AID pointer 
to the first element in the buffer. 



mask - Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 
12 



13 
ID 



Function 

Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder ad- 
dress will be decremented when End-of - 
Cylinder; otherwise, incremented. 

Allow sparing 

Cylinder/surface mode. If set, a cy- 
linder consists of all available sur- 
faces; End-of -Cylinder is set when the 
last sector of the last surface has 
been transferred. In surface mode, 
End-of -Cylinder is set when the last 
sector of any surface has been 
transferred . 



15 



Allow incremental/decremental seek. 



offset - Contains cylinder offset and the separator 
clock information. 

OFFSET WORD FORMAT 



12 3 



H 5 6 7 8 9 10 11 12 13 14 15 
- - A D S - [ CYL OFFSET ] 



- = Don't care 

A = Advance separator clock by 
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10 nanoseconds. 
D = Delay separator clock by 

10 nanoseconds. 
S = Sign bit (offset direction) 
CYL OFFSET = Range of offset (+63 to -63 

moves heads from track center) . 

Increment depends on drive type 



cylinder - cylinder address 

head - head address 

sector - sector address 

NOTE: Default for cylinder, head , sector is 0,0,0. 



OPERATION: This function operates like a normal read except an 
offset word is transmitted to the drive before exe- 
cuting. The cylinder, head and sector parameters are 
passed to the disc controller with an Address Record 
command . 

NOTE: This function is valid for 7906/20/25A moving 
head discs only. This function cannot read a spare 
track with offset. The offset information is lost 
when the controller seeks from a flagged defective 
track to its spare. This is a feature of the con- 
troller. 
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RWOI 

FORMAL NAME: Read With Offset Immediate 



FUNCTION NAME: 



RWOI 



SYNTAX: >RWOI lun.buf (0) , mask, of f set 



PARAMETER: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN de- 
fine buffer name and (0) sets an HP AID pointer 
to the first element in the buffer. 



offset - Contains cylinder offset and 
clock information. 



the separator 



OFFSET WORD FORMAT 



12 3 1 



5 6 7 8 9 10 11 12 13 11 15 
-ADS- t CYL OFFSET ] 



- = Don ' t care 

A - Advance separator clock by 

10 nanoseconds. 
D = Delay separator clock by 

10 nanoseconds. 
S = Sign bit (offset direction) 
CYL OFFSET = Range of offset (+63 to -63 

moves heads from track center) . 

Increment depends on drive type 



OPERATION: This function executes like a normal read except off- 
set word is sent to the disc before executing. Heads 
are assumed to be positioned when using this 
function. 

NOTE: This function is valid for a 7906/20/25A mov- 
ing head disc only and it cannot read a spare track 
with offset. The offset information is lost when the 
controller seeks from a flagged defective track to 
its spare. This is a feature of the controller. 
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RWV 

FORMAL NAME: Read Without Verify 

FUNCTION NAME: RWV 

SYNTAX: >RWV lun,buf( 0) [, mask [, cylinder , head , sector] ] 

PARAMETER: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN define 
buffer name and (0) sets an HP AID pointer to the 
first element in the buffer. 



mask 



Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits Function 

12 Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder 
address will be decremented when End- 
of -Cylinder; otherwise, incremented. 

13 Allow sparing 

It Cylinder/surface mode. If set, a cy- 
linder consists of all available sur- 
faces; End-of -Cylinder is set when the 
last sector of the last surface has 
been transferred. In surface mode, 
End-of -Cylinder is set when the last 
sector of any surface has been 
transferred. 

15 Allow incremental/decremental seek. 

cylinder - cylinder address 

head - head address 

sector - sector address 

Note: Default for cylinder, head, sector is 0,0,0. 
Mask default is surface mode. 
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OPERATION: This function operates like a normal read function 
but does not verify the preceding sector. No address 
checking or sparing operations occur unless a track 
boundary is crossed during the operation. 



NOTE: This function is valid 
moving head discs only. 



only for 7906/20/25A 



EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 DB AA,61HH,0 
>5020 FOR C:=0 TO 410 
>5030 RWV 0,AA(0),2,C,0,0 
>50t0 NEXT 5020 
>5050 RUN 



This example uses the RWV function to 
from an HP 7906A disc. 



read one entire surface 
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RWV! 



FORMAL NAME: Read Without Verify Immediate 

FUNCTION NAME: RWVI 

SYNTAX: >RWVI lun.buf (0) [ ,mask] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN de- 
fine buffer name and (0) sets an HP AID pointer 
to the first element in the buffer. 

mask - Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 



Function 



12 Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder ad- 
dress will be decremented when End-of - 
Cylinder; otherwise, incremented. 

13 Allow sparing 

14 Cylinder/surface mode. If set, a cy- 
linder consists of all available sur- 
faces; End-of -Cylinder is set when the 
last sector of the last surface has 
been transferred. In surface mode, 
End-of -Cylinder is set when the last 
sector of any surface has been 
transferred . 

15 Allow incremental/decremental seek. 



NOTE: Default mask is surface mode. 



OPERATION: This function operates like a normal read operation 
but does not verify the preceding sector. No address 
checking or sparing operations occur unless a track 
boundary is crossed during the operation. The start- 
ing point of the read will be taken from the internal 
disc address. 
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EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 DB AA, 128,0 
>5020 RS 
>5030 RWVI 0,AA(0) 
>501)0 GOTO 5020 
>5050 RUN 

This example randomly seeks and uses the RWVI function to read 
one sector of information. 
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SCB 



FORMAL NAME: Simulated Compare Buffer 

FUNCTION NAME: SCB 

SYNTAX: >SCB lun,bufl(0) ,buf 2(0) .errcount [ .maxcount] 

PARAMETERS: lun - Logical unit number of device being tested. 

bufl(O) ,buf2(0) - Buffers of which the contents are 
to be word by word compared. 

errcount - Maximum number of errors to be displayed 
for each execution. 

maxcount - Maximum number of words to be compared. 
Uses smallest buffer length if defaulted. 



OPERATION: The Compare Buffer command will compare word by word 
each element of buffers 1 and 2. 



%125252,»52525, !FFFF, IAAAA 



EXAMPLE: >5000 DEV 0,6,1,10,0 
>50O5 DB AA.61UH 
>5010 ASSIGN AA(0),(1536; 
>5025 FOR C:=0 UNTIL 822 
>5030 IT 
>50l(0 WDI 0,AA(0),7 
>5045 IT 
>5050 VERI 0,i(8 
>5060 DB BB,6lH4,0 
>5065 IT 
>5070 RDI 0,BB(0),7 
>5080 SCB 0,AA{0) ,BB(0) ,H 
>5090 NEXT 5025 
>5100 RUN 

The above example indicates how a compare buffer operation may be 
used to help evaluate the results of an operation. One track of 
information is written on a 7920A disc. It is then verified and 
compared until the entire disc is checked. 
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SEEK 
FORMAL NAME: Seek 



FUNCTION NAME: SEEK 

SYNTAX: >SEEK lun[ .cylinder, head, sector] 

PARAMETERS: lun - Logical unit number, 
cylinder - Disc parameters 
head - for the moving 
sector - head discs. 
NOTE: Default cylinder, head, sector is 0,0,0. 

OPERATIONS: This function will cause a disc to position its heads 
over the specified cylinder. This function also up- 
dates the internal disc address. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 SEEK 
>5020 SEEK 0,200,3,23 
>5030 SEEK 0,405,1,5 
>50U0 GOTO 5010 
>5050 RUN 

This example executes seek operations on a HF7906/20/25 disc. 
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SELU 

FORMAL NAME: Select Unit 



FUNCTION NAME: SELU 
SYNTAX: >SELU lun.unit 

PARAMETER: lun - Logical unit number 

unit - Temporary unit select in the range of to 3. 
Does not affect the logical unit number. The 
unit does not have to be on-line. 

OPERATION: This function will select the unit specified in the 
unit parameter. 

EXAMPLE: >5000 DEV 3,5,1,10,3 
>5010 SELU 3,1 
>5020 RUN 

This example defines the tape unit as 3, but it selects unit 1. 



3-75 



SLEUTH Simulator Diagnostic Language 

SFM 



FORMAL NAME: Set File Mask 



FUNCTION NAME: SFM 



SYNTAX: 



>SFM lun.mask 



PARAMETERS : lun 
mask 



- Logical unit number. 

Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 
12 

13 
It 



15 



Function 

Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder 
address will be decremented when End- 
of -Cylinder; otherwise, incremented. 

Allow sparing 

Cylinder/surface mode. If set, a cy- 
linder consists of all available sur- 
faces; End-of -Cylinder is set when the 
last sector of the last surface has 
been transferred. In surface mode, 
End-of-Cylinder is set when the last 
sector of any surface has been 
transferred. 

Allow incremental/decremental seek. 



OPERATION: This function will set the file mask on the HP13037 
disc controller from bits 8-15 of the mask parameter. 
When the disc controller is first powered up the mask 
is set to surface mode, where no sparing or automatic 
seeking is performed. 



NOTE: Default for all functions using 
parameter is (surface mode). 



the file mask 



EXAMPLE: >5000 DEV 2,6,1,15,3 
>5010 SFM 2,7 
>5020 RUN 

This example loads the file mask on the 13037 disc controller 
with a value of 7 . 
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FORMAL NAME: Seek Read Data 



FUNCTION NAME: 



SKRD 



SYNTAX: 



>SKRD lun.buf (0) [ ,mask[ , cylinder, head , sector] ] 



PARAMETERS: lun - Logical unit number. 

buf - Buffer into which data is read. Buffer length 
determines word count of read. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN define 
buffer name and (0) sets an HP AID pointer to the 
first element in the buffer. 



mask 



- Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 
12 



13 
lit 



15 



Function 

Incremental/decremental seek. - If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 

Allow sparing 

Cylinder/surface mode. If set, a cylin- 
der consists of all available surfaces; 
End-of-Cylinder is set when the last 
sector of the last surface has been 
transferred. In surface mode, End-of- 
Cylinder is set when the last sector of 
any surface has been transferred. 

Allow incremental/decremental seek. 



cylinder - cylinder address 

head - head address 

sector - section address 

NOTE: Default for cylinder, head, sector is 0,0,0. 
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OPERATION: This function will perform a seek to the specified 
location and read that data into the specified 
buffer. The internal disc address is updated by this 
function. 

EXAMPLE: >5000 DEV 0,6,1,10.2 
>5010 DB AA, 128.0 
>5020 SKRD 0,AA(0),2,10,1,2 
>5030 RUN 
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SKWD 

FORMAL NAME: Seek Write Data 



FUNCTION NAME: SKWD 

SYNTAX: >SKWD lun,buf( 0) [ .mask [, cylinder , head , sector ] ] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer from which data is read, then written to 
disc. Buffer length determines word count of 
read. This parameter bust be any buffer AA(0) 
through NN{0), where AA-NN define buffer name and 
(0) sets an HP AID pointer to the first element in 
the buffer. 

mask - Loads file mask on the 13037 controller only. 
The mask bits are: 

Bits Function 



12 Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End- 
of-Cylinder; otherwise, incremented. 

13 Allow sparing 

Hi Cylinder/surface mode. If set, a cylin- 
der consists of all available surfaces; 
End-of-Cylinder is set when the last 
sector of the last surface has been 
transferred. In surface mode, End-of- 
Cylinder is set when the last sector of 
any surface has been transferred. 

15 Allow incremental/decremental seek. 

cylinder - cylinder address 

head - head address 

sector - sector address 

NOTE: Default for cylinder, head, sector is 0,0,0. 
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OPERATION: This function will issue a seek to specified location 
and read the data, then write it into the specified 
buffer. The internal disc address is then updated. 

NOTE: This function is only valid for 79XX discs 
that are controlled by the 13037 controller. 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 RDB AA(0), 11096 
>5020 DB BB, 4096,0 
>5030 FOR C:=l UNTIL 100 
>50U0 RAND I 
>5050 LET A:=I MOD 111 
>5060 LET B:=I MOD 4 
>5070 LET C:=I MOD 18 
>5080 SKWD 0,AA(0) ,7,A,B,C 
>5090 SKRD 0,BB(0),7,A,B,C 
>5100 IF SS(0) - S7100 THEN 5120 
>5105 SCB 0,AA(0) ,BB(0),3 
>5110 NEXT 5030 

> 51 15 END .Terminates program 

>5120 RSYN 
>5130 DISP 0,Y 
>5150 RUN 

This example uses the SKWD and SKRD functions to test a HP7906 
disc . 
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FORMAL NAME: Switch Output 
FUNCTION NAME: SOUT 
SYNTAX: >SOUT 



OPERATION: Switch output will output error messages to the 
lineprinter or the system console. Initially error 
messages will be output to the system console. Each 
SOUT statement will alternate the output device for 
error messages . 

EXAMPLE: >5000 DEV 0,6,1,10,1 

>5010 DB AA, 128,%052525 

>5020 SOUT 

>5030 FOR B:=0 TO D10 

>501»0 SEEK 0,B,0,0 

>5050 WD 0,AA(0) ,7,B,0,0 

>5070 NEXT 5030 

>5080 RUN 

The above example will switch the reporting of error messages 
from the console to the lineprinter. Note if a lineprinter is 
not connected to the system, the output will default to the 
console. 
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FORMAL NAME: Suppress Status 
FUNCTION NAME: SST 



SYNTAX : 



>SST 



OPERATION: This function will disable status checking for all 
statements following this function statement. Status 
checking can be re-enabled by using the Enable Status 
function. (ES) of AID. 

EXAMPLE: >5000 DEV 5,6,1,10,3 

>5010 DB AA, 128,0 

>5020 SST 

>5030 RD 5, AA(0), 1,822,8,117 

>50i40 PRINT "BUFFER AA(U)=" , AA(«) 

>5050 RUN 

This example suppresses the status error that would normally 
occur when trying to read the last sector of a 7925A disc. Refer 
to the RD* function for more information on 127H5A interface 
operation during a read. The fifth word of the sector is then 
displayed on the console. 
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STAT 



FORMAL NAME: Status Dump 

FUNCTION NAME: STAT 

SYNTAX: >STAT lun[,C or ,D] 

PARAMETERS: lun - logical unit number 

C - Obtains channel registers (0-F) status 
D - Obtains device status 

OPERATION- This statement will obtain status from the channel or 
device specified whether an error has occurred or not 
and print it on the console. If the device is an HP 
7976, the status from the last operation is printed. 



EXAMPLE: >5000 DEV 0,6,1,10,0 
>5020 STAT D 
>5030 RUN 



The above exam 
this case stat 



mple will print the device status of the disc, 
us words 1 and 2 will be displayed on the console 



In 
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TIMEOUT 

FORMAL NAME: Channel Program Timeout Flag 

AID OPERATION NAME: TIMEOUT 

DESCRIPTION: To disable the software timer, the user program 
may set TIMEOUT equal to -1. To increase the 
time allowed by N times, the user may set TIME- 
OUT to N. The timeout period is approximately 3 
seconds . 

INITIALIZED TO: Zero 



EXAMPLE(S) : 


> 5010 


.SET UP FOR SCOPE LOOP 




> 5020 


LET CHANNEL: =2 




> 5030 


TIMEOUT :=-l .DISABLE 1/0 TIMEOUTS 




> 5040 


DB CC,3»!ltO0 .READ DISC ADDRESS 




> 5050 


BSI0 AA 




> 5060 


WR 8,CC(0) ,2 




> 5070 


RR 8,CC(1),H 




> 5080 


GOTO 5060 




> 5090 


RSI0 




> 5100 


RUN 
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FORMAL NAME: Verify 



FUNCTION NAME: 



VER 



SYNTAX: 



>VER lun, secount [ , cylinder, head .sector] 



PARAMETERS: lun - Logical unit number. 

secount - Numbers of sectors to be verified. 

cylinder - cylinder address head - starting head 
address sector - starting sector address 

NOTE: Default for cylinder , head , sector is 0,0,0. 

OPERATION: This function will verify the data on a number of 
sectors on a moving head disc. 

EXAMPLE: >5000 DEV 1,6,1,10,3 

>5010 SFM 1,7 

>502O FOR I:=0 TO 410 

>5030 SEEK 1,1,0,0 

>5040 VER 1,192,1,0,0 

>5050 NEXT 5020 

>506O RUN 

This example verifies one cylinder at a time _ until the entire 
7906 disc is checked. 
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VERI 

FORMAL NAME: Verify Immediate 

FUNCTION NAME: VERI 

SYNTAX: >VERI lun.secount 

PARAMETERS: lun - Logical unit number. 

secount - Number of sectors to be verified. 



OPERATION: This function will verify the data on a number of 
sectors on a moving head disc. The starting point 
will be the internal disc address. 

EXAMPLE: >5000 DEV 4,6,1,15.2 

>5010 DB AA,128,*155555 

>5020 RS 4 

>5030 WDI 4,AA(0) 

>5040 VERI 4,1 

>5050 GOTO 5020 

>5060 RUN 

This example seeks to random locations, writes and verifies one 
sector. 
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WD !D!SO 



FORMAL NAME: Write Data 



FUNCTION NAME: WD 



SYNTAX: >WD lun ,buf( 0) [, mask [, cylinder , head , sector] ] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer from which data is read, then written to 
disc. Buffer length determines word count of 
read. This parameter must be any buffer AA(0) 
through NN(0), where AA-NN define the buffer name 
and (0) sets an HP AID pointer to the first 
element in the buffer. 



mask - Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 



Function 



12 Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 

13 Allow sparing 

14 Cylinder/surface mode. If set, a cylin- 
der consists of all available surfaces; 
End-of -Cylinder is set when the last 
sector of the last surface has been 
transferred. In surface mode, End -of - 
Cylinder is set when the last sector of 
any surface has been transferred. 

15 Allow incremental/decremental seek, 
cylinder - cylinder address 

head - head address 

sector - sector address 

NOTE: Default for cylinder, head, sector is 0,0,0. 
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OPERATION: This function will write the data specified by the 
buf parameter beginning at the location specified by 
the cylinder, head, sector parameters. An Address 
Record command will be issued to the disc controller 
to pass the cylinder, head and sector parameters. 
This is required to simulate the Sleuth format. This 
function updates disc internal address 

EXAMPLE: >5000 DEV 0,6,1,10,0 
>5010 RDB AA(0),61H1 
>5020 FOR I:=0 TO HlO 
>50H0 WD O.AA(0),7,I,0,0 
>5050 NEXT 5020 
>5060 RUN 

This example fills one surface of a HP7906 disc with random data. 
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WD (LP! 

FORMAL NAME: Write Data 

FUNCTION NAME: WD 

SYNTAX: >WD lun.buf (0) .mode, linelength 

PARAMETERS: lun - Logical unit number 

buf - Buffer containing write data. This parameter 
must be any buffer AA(0)-NN(0) where AA-NN 
define buffer name and (0) sets an HF AID 
pointer to the first element in the buffer. 

linelength - Length of each line. 

mode - Format character as indicated below: 



CODE 



BIT 
10 11 12 



COMMAND 



13 It 15 




1 
2 
63 
64 
65 
66 

67 

68 

69 

70 
71 



1 
1 



10 1 
10 1 
10 1 



SUPPRESS SPACE ** 

1 SINGLE SPACE 

1 DOUBLE SPACE 
1 1 63 SPACES 

Chan KTop of form)* 

1 Chan 2 (bottom of form)* 

1 Chan 3 (Single space forms 

step-over)* 
1 1 Chan 1( Double space forms 

step-over) 
Triple space forms step- 
over)* 

1 Next one-half page* 

1 Next one-fourth page* 
1 1 Next one-sixth page* 



"Assigned according to HP programming standards. 

*• Not allowed for 2608A. Results are indeterminate. 
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OPERATION: This function will write data from the specified 
buffer, perform the indicated mode command over 
the length specified by the linelength parameter 
and transmit this data to the lun specified. 



EXAMPLE: >5000 DEV 0,7,2,10,0 
>5010 DB AA, 66, 12315 
>5015 FOR C:= 1 UNTIL 100 
>5020 WD 0,AA(0), 1,132 
>5030 NEXT 5015 
>5040 RUN 
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WD (TAPE) 



FORMAL NAME: Write Data 
FUNCTION NAME: WD 
SYNTAX: >WD lun.buf(O) 



PARAMETER: lun - Logical unit number 

buf - Buffer that contains the write data. This 
parameter must be ar.y buffer AA(0)-NN(0) 
where AA-NN define buffer name and (0) sets 
an HP AID pointer to the first element in the 
buffer. 



OPERATION: 



This function will execute a write operation 
specified unit. 



on the 



EXAMPLE: >5000 DEV 0,5,1,10,0 

>5010 RDB AA(0),8000 (statement takes approx. «5 sec) 

>5015 FOR C:= 1 UNTIL 50 

>5020 WD 0,AA(0) 

>5030 NEXT 5015 

>5010 REW 

>5050 RUN 

This example writes records of 8000 random words of data 50 
times on mag tape unit 0. 
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WDI 



FORMAL NAME: Write Data Immediate 



FUNCTION NAME: WDI 



SYNTAX: >WDI lun,buf (0) [ ,mask] 
PARAMETERS: lun - Logical unit number. 



buf 



mask 



- Buffer from which data is read, then written to 
disc. Buffer length determines word count of 
read This parameter must be any buffer AA(0) 
Through NN(0), where AA-NN define buffer name and 
(0) sets an HP AID pointer to the first element in 
the buffer. 

- Loads file mask on the 13037 controller only. 
The mask bits are: 



Bits 



Function 



12 



Incremental/decremental seek. If set 
and bit 15 is a 1, the cylinder address 
will be decremented when End-of- 
Cylinder; otherwise, incremented. 



13 
1H 



15 



Allow sparing 

Cylinder/surface mode. If set, a cylin- 
der consists of all available surfaces; 
End-of-Cylinder is set when the last 
sector of the last surface has been 
transferred. In surface mode, End-of- 
Cylinder is set when the last sector of 
any surface has been transferred. 

Allow incremental/decremental seek. 



OPERATION- This function will write data on a moving head disc. 
The internal disc address will designate the starting 
point of the write operation. This function updates 
the internal disc address. 

EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 DB AA.128.S155555 

>502O RS 

>5030 WDI 0,AA{0) ,7 

>50«0 GOTO 5020 

>5050 RUN 
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WFM 

FORMAL NAME: Write File Mark 

FUNCTIONAL NAME: WFM 

SYNTAX: >WFM lun 

PARAMETER: lun - Logical unit number 

OPERATION: This function will write a file mark on the 
specified unit. 

EXAMPLE: >5000 DEV 0,5,1,10,0 >5010 DB FF , 6000 ,£22222 >5020 
WD 0,FF(0> >5030 WFM >5040 REW >5050 FSF >506D 
REWOFF >5070 RUN 

This example writes a file mark on mag tape, rewinds and then 
forward spaces to the file mark. 

* This parameter must be any buffer AA(0) through NN(0) where AA 
through NN define buffer name and (0) sets an HP AID pointer to 
the first element in the buffer. 
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wrs 

FORMAL NAME: Write Full Sector 

FUNCTION NAME: WFS 

SYNTAX: >WFS lun, buf( )[, cylinder, head , sector ] 

PARAMETERS: lun - Logical unit number. 

buf - Buffer from which data is read, then written to 
disc. Buffer length determines word count of 
read. This parameter must be any buffer AA(0) 
through NN(0), where AA-NN define buffer name and 
(0) sets an HP AID pointer to the first element in 
the buffer. 

cylinder - starting cylinder address 

head - starting head address 

sector - starting sector address 

NOTE: Default for cylinder .head , sector is 0,0.0. 



OPERATION: 



EXAMPLE: 



This function will write a full sector on a moving 
head disc . Note the disc should be formatted after 
this operation. This function writes over the 
address field. 

NOTE: This function is valid for 7910 and 79XX discs 
only. It updatesthe internal address of the disc. 



:=400,AA(2) :=!305 



>5000 DEV 1,6,1,10,2 
>5010 DB AA,138,JU25252 
">5015 LET AA(0) :=!80FE,AA(1) 
>5O20 DB BB, 138,0 
>50U0 WFS l.AA(0) ,1400,1,5 
>5050 RFS 1,BB(0), H00,l, 5 
>5060 SCB 1,AA(0),BB(0),5 
>5070 RUN 

• AA(0) equals the sync word. 

This example performs a single write full sector and a read full 
sector on a HP7906/20/25A disc. The buffers are then checked to 
verify the data. 
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WFSI 

FORMAL NAME: Write Full Sector Immediate 



FUNCTION NAME: WFSI 



SYNTAX : 



>WFSI lun.buf(O) 



PARAMETERS : 



OPERATION: 



lun - Logical unit number. 



from which data is read, then written to 

Buffer length determines word count of 

This parameter must be any buffer AA(0) 

NN(0), where AA-NN define buffer name and 

(0) sets an HP AID pointer in the first element in 

the buffer. 



Buffer 

disc. 

read. 

through 



OPERATION- This function will perform a full sector write opera- 
tion on a 7910K and 7906/20/25A discs only. The 
internal disc address will be used and updated as the 
starting point. 

EXAMPLE: >5000 DEV 0,6,1,10,0 

>5010 RDB AA(0),138 
>5020 DB BB, 138,0 
>503O SEEK 
>503H RFSI 0,AA(0) 
>5037 LET AA(5):= -AA(5) 
>50«0 WFSI 0,AA(0) 
>5050 RDI 0,BB(0) 
>506O RUN 

This example uses the WFSI function to force a possible correct- 
able data error negating the sixth word of buffer AA and using 
the original CRC value. 
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4 INTRODUCTION 

There are five types of CS/80 commands; Real Time, Complementary, 
General Purpose, Transparent, and Diagnostic. Real Time CS/80 
commands currently implemented as SLEUTHSM functions are: LOCRD, 
RDI, LOCWR, WDI, and WFM; complementary commands are: UNIT, VOL- 
UME, SETADDR.SBLKDISP, LENGTH, BURST, RPS, SETRETIM, MASKSTAT, 
NOP, SETREL, SETOPTS, and RETADMOD; general purpose commands are 
DESCRIBE, FMT, SPAREBLK, LOCVER, LOCVERI, RELEASE, and 
RELDEN; transparent commands are CANCEL, LOOPBACK, and PCHECK; 
and STATUS, LOCRFS, and RFSI . The Diagnostic commands 
implemented are: DEV, MC (Master Clear, an HP-IB command) and RS 
(Random Seek, implemented with other CS/80 commands) are also 
CS/80 compatible. 

Real time commands are the data transfer commands. Complementary 
commands are used to set or update programmable operating para- 
meters in the device. These parameters are assigned initial 
values at power on. Complementary commands can be transmitted in 
two ways: in a separate transaction or in the same transaction as 
a Real Time command. The SLEUTHSM implementations of the CS/80 
commands use a separate transaction for all commands except for 
LOCRD and LOCWR which have the LENGTH and SETADDR commands inclu- 
ded in their command strings . 



The current value of the address, that is the target address, 
is updated by additional mechanisms. The SETBLKDISP (Set Block 
Disp- placement) command changes the target address by the 
amount of its parameter. Also following a data transfer, the 
target address is set to the value of the block following the 
last block trans- f erred. This allows serial access of a 
device. 

The following pages contain descriptions of the CS/80 commands 
added to SLEUTHSM in alphabetical order. 
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3.2 CS/80 COMMAND INDEX 



1 Command | Description I Page I 


1 BURST | Set Burst I 4-4 | 


I CANCEL | Cancel 1 4-6 | 


| DESCRIBE | Describe I 4-7 | 


I DEV | Device 1 4-8 I 


I PMT | Format 1 4-10 | 


I LENGTH | Set Length 1 4-11 | 


I LOCRD I Locate and Read I 4-12 | 


1 LOCRFS I Locate and Read Full Sector I 4-14 | 


I LOCVER I Locate and Verify | 4-16 | 


I LOCVERI | Locate and Verify Immediate | 4-17 1 


1 LOCVm I Locate and Write 1 4-18 1 
I LOOPBACKI HP- IB Loopback I 4-20 I 


I MASKSTATI Set Status Mask I 4-21 | 


1 MC I Master Clear 1 4-22 | 


I NOP | No Op I 4-23 1 


I PCHECK I HP-IB Parity Check | 4-24 | 


I RDI | Read Data Immediate | 4-25 1 


1 RELDEN I Release Denied | 4-26 | 


I RELEASE | Release 1 4-27 1 


I RETADMODI Set Return Addressing Mode | 4-28 | 


I RFSI I Read Full Sector Immediate | 4-29 1 


I RPS I Set Rotational Position Sensing 1 4-30 I 


I RS | Random Seek | 4-31 | 



4-2 



SLEUTH Simulator Diagnostic Language 



j SBLKDISPJ Set Block Displacement | 4-32 1 


1 SETADDR I Set Address 1 4-33 1 


| SETOPTS | Set Options 1 4-35 1 


| SETREL | Set Release 1 4-36 1 


| SETRETIHI Set Retry Time 1 4-37 1 


I SPAREBLKI Spare Block 1 4-38 | 


I STATUS | Request Status 1 4-39 1 


| UNIT I Set Unit 1 4-40 | 


I VOLUME | Set Volume 1 4-41 | 


I WDI I Write Data Immediate 1 4-32 1 


| WFM | Write File Mark 1 4-43 1 
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BURST 



FORMAL NAME: Set Burst 

FUNCTION NAME: BURST 

SYNTAX: > BURST lun.bc 

PARAMETERS: lun - Logical unit number (0 to 7). 

be - Specifies the burst count (0 - 255). The burst 
count is the number of 256 byte segments con- 
tained in each burst. A value of all 0's deact- 
ivates burst mode. 

Sets the "set" value of the burst count. A burst 
count less than or equal to the device's buffer will 
result in transfers at the buffers speed, burst 
counts larger than the buffer will transfer at the 
same speed as an unbuffered transfer. If Burst mode 
is deactivated (burst count = 0) all the information 
is transfered in a single transfer. This is the power 
on default. Deactivated Burst mode is assumed in all 
CS/80 Sleuth Simulator data transfer commands com- 
mands. A modified channel program is required to use 
burst mode . 



OPERATION: 



EXAMPLE: >5000 
>5010 
>5020 
>5030 
>50H0 

>5050 
>5060 
>5070 
>5080 
>5090 
>5ioo 
>5iio 

>5120 
>5130 
>51t0 
>5150 
>5l6o 
>5170 
>5l8o 
>5190 
>5200 
>5210 
>5220 
>5230 
>5210 
>5250 
>5260 



DB AA, 381,0 

DB BB, 3814,0 

PPRINT "DEV" 

DEV 0,7,3,1,0 

FOR I:=0 UNTIL 383 

LET BBCI) :=I*3 

NEXT 5010 

PPRINT "LOCWR" 

LOCWR 0,BB(0), 0,0, 0,50 

PPRINT "SETADDR" 

SETADDR 0,0,0,0,50 

PPRINT "LENGTH" 

LENGTH 0,0,768 

PPRINT "BURST 0,1" 

BURST 0,1 

LET WW (112):=0,P:=1 

BSIO XX 

WR !5,WW(112),F 

WAIT 

RB !E,AA(0),768,256 

JUMP 5220 

JUMP 5180 

WAIT 

DSJ 52tO;Z 

IN H.1,1 

RSIO XX 

CB AA(O),BB(0),381J 
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>5270 IF INDEX--1 THEN 5300 

>5280 PRINT "COMPARE FAILED, INDEX= "; INDEX 

>5290 END 

>5300 PRINT "COMPARE SUCCESSFUL, INDEX= "; INDEX 

>5310 END 
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FORMAL NAME: Cancel 

FUNCTION NAME: CANCEL 

SYNTAX: > CANCEL lun 

PARAMETER: lun - Logical unit number (0 to 7). 

OPERATION: Cancel is a way to terminate a transaction. The Can- 
cel command will terminate the transaction in pro- 
gress without reseting the device to its power on 
state (unlike MC) . 



EXAMPLE: >5000 DEV 0,7,3,10.0 
>5020 CANCEL 
>5030 END 



US 
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DESCRIBE 



FORMAL NAME: Describe 

FUNCTION NAME: DESCRIBE 

SYNTAX: >DESCRIBE lun.buf(O) 

PARAMETERS: lun - Logical unit number (0 to 7). 

buf - A buffer into which the information 
will be returned. 

OPERATION: Returns data concerning the device type and 
characteristics. Five bytes of data are returned con- 
cerning the controller, nineteen bytes for each unit, 
and thirteen bytes for each volume. A maximum of 256 
and minimum of 37 bytes of data are returned. The 
buffer must be larger than the amount of data that 
the device will generate or an error will result. 
(Refer to Appendix B for a summary of the DESCRIBE 
format . ) 

EXAMPLE: >5000 DEV 0,7,3,10,0 
>5010 DB AA.20 
>5020 DESCRIBE 0,AA(0) 
>5030 LET A:=AA(13) AND IFF 
>50«0 PRINT "MAX HEAD ADDRESS^ ";A 
>5050 END 
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DEV 



FORMAL NAME: 



Device 



FUNCTION NAME: 



DEV 



SYNTAX: >DEV lun.chan.dev, errs , unit . 1MB 
PARAMETERS: lun - Logical unit number (0 to 7). 



chan 



Channel number to which the device is 
connected to (0 to 15). 



dev - HP-IB device number (0 to 7). 

errs - Maximum error count the device is 

allowed (1 to 999). Not used by CS/80 
devices . 

unit - Device unit number (0 to 15). 



density 



Not used by CS/80 devices. Used to 
specify the density of 7970 tapes. 



1MB - InterModule Bus number that the channel is 
connected to. Will normally be zero (0) unless the 
system is a Series 64. Possible 1MB numbers on 
this system are thru 2. 

OPERATION: The Device statement allows the user to define the 
characteristics of a particular device and a logical 
unit number to that device. This function will test 
for boundaries on all parameters, see if the entered 
channel and device type are present, identify the de- 
vice, obtain the device type and store the parameters 
in buffer ZZ for future use. The DEV function buffer 
(ZZ) is structured as described in Appendix A. If any 
of the parameters exceed the boundaries or if a non- 
existant channel or device has been entered, then an 
error message is output to the console and the pro- 
gram ends . 

With CS/80 devices the DEV statement will, in addi- 
tion to the above, transmit the Unit complementary 
command. The controller is always unit 15 on CS/80 
devices. The media is unit on single unit CS/80 
devices. The SETRETIM (Set Retry Time) command can 
be used with CS/80 devices to achieve a function 
similar to the "errs" parameter. 

EXAMPLE: >5000 DEV 1,7,2,1,0 
-0R- 
>5000 DEV 0,6,1,1,0 

NOTE 
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It is not good style to include the DEV command inside LOOP 
constructs as once it has been executed, repeating it would 
consume time for no purpose relevant to the LOOP. 
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FMT 



FORMAL NAME: Format 
FUNCTION NAME: FMT 
SYNTAX: >FMT lun.opt ,blk 

PARAMETERS: lun - Logical unit number (0 to 7). 
opt - Format options; 

opt=0 specifies reformat volume 

retaining all factory and field 
spares ; 

opt=l specifies reformat volume 

retaining only factory spares . 

blk - Specifies the block interleave factor. 



OPERATION : 



EXAMPLE: 



Factory spares are always retained . The user may 
or may not save field spares , but do not take this 
action lightly. Bad sectors flagged by the field 
spares which are reformatted as good will cause disc 
errors later. Reformatting not retaining field spares 
should be followed by extensive diagnostics to deter- 
mine which sectors to spare. 

The block interleave factor is to allow slower data 
transfer rates . The power on value is and has the 
same meaning as a value of 1 (no interleaving). The 
maximum factor allowed is found in the Describe com- 
mand. Note the format command may take a reasonable 
amount of time to complete depending on the size of 
the disk. Approximately 15 minutes is required for 
the 7935 disk. 

IMPORTANT 

FMT will destroy all user data on 
the unit selected! 

>5000 TIMEOUT: =100 
>5010 DEV 0,7,4,1,0 
>5020 FMT 0,0,0 
>5030 END 



4-10 



SLEUTH Simulator Diagnostic Language 



LENGTH 



FORMAL NAME: Set Length 
FUNCTION NAME: LENGTH 



SYNTAX: 



> LENGTH lun.lenh.lenl 



PARAMETERS: lun - Logical unit number {0 to 7). 

lenh - The high two bytes of the four byte 

unsigned binary number specifying the 
length of the data transfer in bytes . 

lenl - The low two bytes of the length. 

OPERATION: Sets the "set" value of LENGTH to the value speci- 
fied. The transfer length is specified in bytes. A 
length of will cause a data transfer command to ex- 
ecute a seek with no data transfer. A length of all 
of all 1 ' s will cause a full volume transfer of the 
selected volume. A full volume transfer is the power 
on default . The volume size is available from the 
describe command. 

EXAMPLE: >5000 DEV 0,7,3,1,0 

>5010 LENGTH 0,0.10000 

>5020 VOLUME 0,0 

>5030 SETADDR 0,0,0,0,10,1 

>50D0 LOCVERI 

>5050 END 
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LOCRD 

FORMAL NAME: Locate and Read 

FUNCTION NAME: LOCRD 

SYNTAX: >LOCRD lun.buf(O) .mode, cylh, cyll, head, sector 

PARAMETERS: lun - Logical unit number (0 - 7). 

buf(0) - Buffer into which data from disc is 
written. This parameter must be any 
buffer AA(0)-NN(0) where AA-NN define 
the buffer name and (0) sets an HP AID 
pointer to the first element in the 
buffer. 

mode - Specifies the address mode used (0 to 1). 

mode=0 => single vector 
mode^l = > 3-vector 

mode = Interpret the remaining parameters as 
follows . 

cylh - High two bytes of six byte unsigned 
logical address . 

cyll - Middle two bytes of logical address. 

head - Low two bytes of logical address. 

sector - Disregarded. 

mode = 1 Interpret the remaining parameters as 
follows. 

cylh - The low byte of this parameter is used 
as the high byte of the three byte 
cylinder address (0 to 255)- 

cyll - The low two bytes of the cylinder address. 

head - The low byte of this parameter is used 

as the one byte head address (0 to 255)- 

sector - This parameter is used as a 16 bit 

unsigned integer which specifies the 
sector address. 

OPERATION: This function will perform a seek and read of 
CS/80 devices. The length of the transfer is 
assumed to be equal to the length of the buffer. 
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For a specific device the address values are 
limited as specified by the Describe command. 



EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB AA.102U 
>5020 DB BB,102H 
>5030 RDB AA.102H 
>50J40 LOCWR 0,AA(0),1 
>5050 LOCRD 0,BB{0),1 
>5060 CB AA(0),BB(0),102H 
>5070 IF INDEX=-1 THEN 5120 
>5080 PRINT 
INDEX 
>5090 PRINT 
>5100 PRINT 
>5110 END 
>5120 PRINT 
>5130 END 



.Randomize Data buffer 

0,0,10,20 

0,0,10,20 

Compare Buffer 

Buffers failed to compare at location" 

"BB( " ; INDEX; ")=%" ;BB(INDEX) 
"should be %" ;AA(INDEX) 

"Compare successful." 
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LOCRFS 

FORMAL NAME: Locate and Read Pull Sector 

FUNCTION NAME: LOCRFS 

SYNTAX: >LOCRFS lun,buf(0) , mode, cylh, cyll.head, sector 

PARAMETERS: lun - Logical unit number (0 to 7). 

buf(0) - The buffer into which the sector is 
returned. It must be large enough for all 
the data to be returned. The amount of data 
returned is equal to the device's block 
size plus the header and trailer. For CS/80 
discs the buffer must be at least 135 words 
long. 

mode - Specifies the address mode used (0 to 1). 

mode=0 => single vector 
mode=l = > 3-vector 

mode = Interpret the remaining parameters as 
follows . 

cylh - High two bytes of six byte unsigned 
logical address. 

cyll - Middle two bytes of logical address. 

head - Low two bytes of logical address. 

sector - Disregarded. 

mode = 1 Interpret the remaining parameters as 
follows . 

cylh - The low byte of this parameter is used 
as the high byte of the three byte 
cylinder address (0 to 255). 

cyll - The low two bytes of the cylinder 
address . 

head - The low byte of this parameter is used as 
the one byte head address (0 to 255). 

sector- This parameter is used as a 16 bit 

unsigned integer which specifies the 
sector address. 

OPERATION: Causes the full sector (header, data, and trailer: to 
be read into the buffer from CS/80 devices. See the 
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RFS command for non-CS/80 devices. See information 
on each device for the format of the header and 
trailer. The address is specified in a manner 
identical to the LOCRD statement. For a specific 
device the address values are limited as specified 
by the Describe command. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB AA.135 

>5020 LOCRFS 0,AA(0), 1,0,5.2, 30 
>5030 FOR I:=0 STEP 1 UNTIL 13* 
>5040 PRINT I;" ";AA(I) 
>5050 NEXT 5030 
>5060 END 
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LOCVER 



FORMAL NAME: Locate and Verify 
FUNCTION NAME: LOCVER 

SYNTAX: >LOCVER lun, mode , cylh, cyll , head, sector 
PARAMETERS: lun - Logical unit number (0 to 7). 
mode - Address mode used: 



mode = 
mode = 1 



single vector, 
three vector. 



cyll 



OPERATION: 



EXAMPLE : 



mode • interpret the remaining parameters as : 

cylh - High two bytes of six byte unsigned 

single vector address, 
cyll - Middle two bytes of the single vector 

address, 
head - Low two bytes of the single vector 

address, 
sector - Disregarded. 

mode ■ 1 interpret the remaining parameters as : 

cylh - The low byte of this parameter is used 
as the high byte of the three byte 
cylinder address (0 to 255 ) ■ 
The low two bytes of the cylinder 
address. 

head - The low byte of this parameter is used 
for the head address (0 to 255). 

sector - This parameter is used as a 16 bit 

unsigned integer which specifies the 
sector address. 

Instructs the device to perform an internal verifica- 
tion of a section of data to insure that it can be 
read. No data is transfered to the host. The length 
of the data to be verified is the value of the last 
specified LENGTH (either by a LENGTH command or by a 
data transfer command which contain length commands). 
During verification all correctable data errors are 
logged into the error log. An uncorrectable data er- 
ror will cause the verification to immediatly halt. 

>5000 DEV 0,7,3,1,0 
>5010 LENGTH 0.0,1000 
>5020 LOCVER 0,1,0,100,5.50 
>5030 END 
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LOCVERI 



FORMAL NAME: Locate and Verify Immediate 
FUNCTION NAME: LOCVERI 



SYNTAX : 



> LOCVERI lun 



PARAMETER: lun - Logical unit number (0. to 7). 



OPERATION : 



EXAMPLE : 



Instructs the device to perform an internal 
verification of a section of data to insure that it 
can be read. No data is transfered to the host. The 
address and length of the data to be verified are the 
last values set. During verification all correctable 
data errors are logged into the error log. An uncor- 
rectable data error will cause the verification to 
immediately halt . 

>5000 DEV 0,7,3,1,0 

>5010 LENGTH 0,0,10000 

>5020 VOLUME 0,0 

>5030 SETADDR 0,0,0,0,10,1 

>50M0 LOCVERI 

>505O END 



4-17 



SLEUTH Simulator Diagnostic Language 

LOCWR 

FORMAL NAME: Locate and Write 

FUNCTION NAME: LOCWR 

SYNTAX: >LOCWR lun, buf( ) ,mode, cylh, cyll .head , sector 

PARAMETERS: lun - Logical unit number (0 - 7). 

buf(O) - Buffer of data which is transfered to 
disc. This parameter must be any 
buffer AA(0)-NN(0) where AA-NN define 
the buffer name and (0) sets an HP AID 
pointer to the first element in the 
buffer. 

mode - Specifies the address mode used (0 to 1). 

mode=0 => single vector 
mode=l => 3-vector 

mode = Interpret the remaining parameters as 
follows . 

cylh - High two bytes of six byte unsigned 
logical address. 

cyll - Middle two bytes of logical address . 

head - Low two bytes of logical address . 

sector - Disregarded. 

mode = 1 Interpret the remaining parameters as 
follows . 

cylh - The low byte of this parameter is used 
as the high byte of the three byte 
cylinder address (0 to 255)- 

cyll - The low two bytes of the cylinder 
address . 

head - The low byte of this parameter is used 

as the one byte head address (0 to 255 ) ■ 

sector- This parameter is used as a 16 bit 

unsigned integer which specifies the 
sector address. 

OPERATION: This function will perform a seek and write to 
CS/80 devices. The length of the transfer is 
assumed to be equal to the length of the 
buffer. 
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EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB AA.102H 
>5020 DB BB.1024 

>5030 RDB AA(0),102U .Randomize Data buffer 
>50D0 LOCWR 0,AA(0),1,0,0,10,20 
>5050 LOCRD 0,BB(0),1,0,0,10,20 
>5060 CB AA(0),BB(0),102H .Compare Buffer 
>50"0 IF INDEX=-1 THEN 5120 
>5080 PRINT "Buffers failed to compare at location ; 

INDEX 
>5090 PRINT "BB(";INDEX;")=%";BB(INDEX) 
>5100 PRINT "should be %";AA(INDEX) 
>5110 END 

>5120 PRINT "Compare successful." 
>5130 END 
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LOOPBACK 
FORMAL NAME: HPIB Loopback " «.«" = = = 

FUNCTION NAME: LOOPBACK 
SYNTAX: > LOOPBACK lun, type.buf (0) 
PARAMETERS: lun - Logical unit number (0 to 15). 

type - Read or write Loopback: 

type = o => read Loopback, 
type = 1 => write Loopback. 



OPERATION: 



EXAMPLE: 



buf - Buffer containing the data to transfer. 

This function checks the data path from the cpu to the 
device with data transfers in either direction. The 
^2 g K„° f th £ data transf er is equal to the size of 
the buffer. The data pattern must start with HEX FF 
ll£h ""I, re ? eat r in E as necessary for the specified 
F^f^./f write Loopback fails the Channel Parity 
Error bit in the Status message will be set. The user- 
must check the data received from the device with the 
read Loopback command to determine its validity. 

>5000 DEV 0,7,3,1,0 
>5010 DB AA, 256,-1 
>5020 DB BB, 256,0 
>5030 LOOPBACK 0,0,AA(0) 
>5010 LOOPBACK 0,1,AA(0) 
>5050 LOOPBACK 0,0,BB(0) 
>5060 LOOPBACK 0,1,BB(0) 
>5070 END 



iJ-20 



SLEUTH Simulator Diagnostic Language 



MASKSTAT 

FORMAL NAME: Set Status Mask 

FUNCTION NAME: MASKSTAT 

SYNTAX: >MASKSTAT lun,ml ,m2 ,m3,m4 



PARAMETERS: lun - Logical unit number ( to 15). 

ml - First two bytes of the eight byte status mask. 

m2 - Third and fourth bytes. 

m3 - Fifth and sixth bytes. 

mk - Seventh and eight bytes. 



OPERATION: 



EXAMPLE : 



The eight byte status mask is a bit mask whose bit 
positions correspond to those of the Request Status 
command. A bit value of 1 masks the error in the cor- 
responding position. It prevents the error from be- 
ing reported in either the Request Status or QSTAT. 
This command enables an error to be masked letting 
the parameters field correspond to another error. 
Note some errors are unmaskable. 

>5000 DEV 0,7,3,1,0 

>5010 DB AA.10 

>5020 MASKSTAT 0,0,8,0,0 

>5030 STATUS AA(0) 

>50H0 PRINT "STATUS ="; 

>5050 FOR I:=0 STEP 1 UNTIL 9 

>5060 PRINT AA(1) 

>5070 NEXT 5050 

>5080 END 
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MC 



FORMAL NAME: Master Clear 



FUNCTION NAME: MC 



SYNTAX : 



>MC lun 



PARAMETER : 



lun - Logical unit number ( 0-7 ) ■ 



OPERATION: This function will clear the specified unit by 

issuing a device clear. This will reset all the 
programmable operating parameters to their power-on 
defaults. 

EXAMPLE: >5000 DEV 4,6,1,1,0 
>5010 DB AA.37 
>5020 SETADDR 4,0,0,100 
>5030 STATUS 1|,AA(0) 
>5040 PRINT "ADDRESS =";AA(7) 
>5050 MC 4 

>5060 STATUS 4,AA(0) 
>5070 PRINT "ADDRESS =";AA(7) 
>5080 END 



.Note the full 
.address is in 
AA(5)-AA(7) 



This example illustrates how a master clear (MC) will reset 
the programable parameters to their power on defaults in 
CS/80 devices. 
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NOP 



FORMAL NAME: No Op 

FUNCTION NAME: NOP 

SYNTAX: >NOP lun 

PARAMETER: lun - Logical unit number (0 to 7). 



OPERATION: 



EXAMPLE : 



Causes the device to disregard the message byte. 
The complementary command NOP is normally used 
to adjust command strings to word boundaries . In 
this use it does nothing and can be used to 
check proper processing of a command not using 
the execution phase. 

>5000 DEV 0,7,3,1,0 
>5010 NOP 
>5020 END 
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PCHECK 

FORMAL NAME: HP-IB Parity Checking 

FUNCTION NAME: PCHECK 

SYNTAX: >PCHECK lun.v 

PARAMETERS: lun - Logical unit number (0 to 7). 

v - Sets parity checking on (v=l), or off (v=0) . 

OPERATION: Causes the device to detect channel command 
parity errors (v=l), or to not detect them (v=0). 
Parity checking off is the power-on default. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 PCHECK 0,0 
>5020 END 
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RD1 



FORMAL NAME: Read Data Immediate 

FUNCTION NAME: RDI 

SYNTAX: >RDI lun.buf(O) 

PARAMETERS: lun - Logical unit number (0 to 7). 

buf(0) - Buffer into which data from the device 
is written. This parameter must be any 
buffer AA(0) - NN(0) where AA-NN define 
the buffer name and (0) sets an HP AID 
pointer to the first element of the 
buffer. 

This function will perform a seek and read of CS/80 
devices. The buffer size determines the size of the 
data transfer. The address is the current target ad- 
dress. The target address can be set with the SETADDR 
command . 

>5000 DEV 0,7,3,1.0 

>5010 DB AA.102U 

>5020 VOLUME 0,0 

>5040 SETADDR 0,1,0,10,5,0 

>5050 RDI 0,AA(0) 

>5060 FOR I:-0 STEP 1 UNTIL 1023 

>5070 PRINT I;" ";AA(I) 

>5080 NEXT 5060 

>5090 END 



OPERATION: 



EXAMPLE : 
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RELDE.N 

FORMAL NAME: Release Denied 

FUNCTION NAME: RELDEN 

SYNTAX: > RELDEN lun 

PARAMETER: lun - Logical unit number (0 to 7). 

OPERATION: The Release Denied command is used by the host to re- 
spond to a release request from the device. Respond- 
ing with Release Denied will prevent the device from 
going offline to service the request. Also see the 
SETREL (Set Release) command. The controller is the 
unit to which the RELEASE and RELDEN commands must be 
addressed so the unit is set to 15 for the command 
and then following the command it is returned to the 
value it had before the command . 

EXAMPLE: >5000 DEV 0,7,3.10,0 
>5010 RELDEN 
>5020 END 



4-26 



SLEUTH Simulator Diagnostic Language 



RELEASE 



esssssssxsssxssssssssss 

FORMAL NAME: Release 



FUNCTION NAME: 



RELEASE 



SYNTAX: > RELEASE lun 

PARAMETER: lun - Logical unit number (0 to 7). 

OPERATION: The Release command is used by the host to respond to 
a release request from the device. Responding with 
Release will let the device go off-line while the 
device services the request. If the host does not 
communicate with the device within 2 seconds of the 
device requesting release the device will release 
itself. Also see the SETREL (Set Release) command. 
The controller is the unit to which the RELEASE and 
RELDEN commands must be addressed so the unit is set 
to 15 for the command and then following the command 
it is returned to the value it had before the com- 
mand . 



EXAMPLE: >5000 DEV 0,7,3,1. 
>5010 RELEASE 
>5020 END 



15 
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RETADMOD 



FORMAL NAME: Set Return Addressing Mode 

FUNCTION NAME: RETADMOD 

SYNTAX: > RETADMOD lun.mode 

PARAMETERS: lun - Logical unit number (0 to 7). 

mode - Specifies the addressing mode: 

mode=0 «> single-vector, 
mode=l ■ > three-vector. 

OPERATION: This command allows the host to specify the type of 
address (single or three-vector) returned by the Re- 
quest Status command. The power-on default is 
(single vector) . 

EXAMPLE: >5000 DEV 0,7,3,1,0 .uses the device to 
>5010 DB BB,10 .convert addresses 
>5020 LET D:=100,E:=8,F:=21 
>5030 SETADDR 0,1,0,D,E,F 
>50l»0 RETADMOD 0,0 
>5050 STATUS 0,BB(0) 

>5060 PRINT "3 VECTOR CYL=";D;" HEAD=";E;" SEC=";F 
>5070 PRINT "SINGLE VECTOR*" ; 88(6) ;2;BB(7) ;2;BB( 8) 
>5O80 END 
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RFSI 



FORMAL NAME: Read Full Sector Immediate 



FUNCTION NAME: RFSI 



SYNTAX: >RFSI lun.buf(O) 



PARAMETERS: 



lun - Logical unit number (0 to 7). 



buf(0) - The buffer into which the sector is 

returned. It must be large enough for 
all the data to be returned. The 
amount of data returned is equal to 
the device's block size plus the 
header and trailer. For CS/80 discs 
the buffer must be 135 words long. 

OPERATION: Causes the full sector (header, data, and trailer) to 
be read into the buffer. See information on each 
device for the format of the header and trailer. For 
CS/80 devices the address is the current target ad- 
dress . 



EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB AA.135 
>5020 VOLUME 0,0 
>50H0 SETADDR 0,1,0,10,5,0 
>5050 RFSI 0,AA(0) 
>5060 FOR I:-0 STEP 1 UNTIL 13*4 



>5O70 PRINT I;" 
>5080 NEXT 5060 
>5090 END 



■;AA(I) 
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RPS 



FORMAL NAME: Set Rotational Position Sensing 



FUNCTION NAME: 



RPS 



SYNTAX : 



PARAMETERS : 



>RPS lun.tl.tl 

lun - Logical unit number (0 to 7 
tl 



t2 



Specifies the time-to-target in 100 's of 
microseconds (0 - 255)- 

Specifies the window size in 100 's of 
microseconds (0 - 255)- 



OPERATION: RPS is used to cause the device to request an execu- 
tion message only when the sector to be read is a 
certain time from the head (tl). The device must 
then receive an execution message within the time 
window (t2) for it to begin a data transfer. If the 
host does not respond with an execution message 
within the time t2 the device will remove the re- 
quest until the next window. A value of tl = will 
disable RPS. The power-on default is that RPS is 
disabled . 

EXAMPLE: >5000 DEV 0.7,3,1,0 

>5010 DB AA.102U 

>5020 RPS 0,0,0 

>5030 LOCRD 0,AA(0),1,0,25,6,140 

>50H0 END 
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FORMAL NAME: Random Seek 



FUNCTION NAME: 



RS 



SYNTAX: >RS lun 

PARAMETER: lun - Logical unit number (0 to 7). 

OPERATION: This function will cause a moving head disc to seek 
randomly. This function will update the internal 
disc address. This command will function with CS/80 
devices . 

EXAMPLE: >5000 DEV 1,7,3,1,0 

>5010 FOR I:=l UNTIL 100 
>5020 RS 1 
>5030 NEXT 5010 
>5010 END 
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SBLKD1SP 

FORMAL NAME: Set Block Displacement 

FUNCTION NAME: SBLKDISP 

SYNTAX: SBLKDISP lun.displ ,disp2 , disp3 

PARAMETERS: lun - Logical unit number (0 to 7). 

displ - High two bytes of the six byte signed 
two's complement binary number which 
specifies the block displacement. 

disp2 - The middle two bytes of the 
displacement. 

disp3 - The low two bytes of the displacement. 

OPERATION: Adds the displacement to the current target address. 
Note that the displacement can be positive or nega- 
tive. The new target address is then tested for 
bounds violations. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB,AA,500 
>5020 SETADDR 0,0,0,0,10 
>5030 SBLKDISP 0,0,0,1 
>50«0 STATUS 0,AA(0) 
>5050 PRINT "Address =";AA(7) 
>5060 END 
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SETADDR 

FORMAL NAME: Set Address 

FUNCTION NAME: SETADDR 

SYNTAX: >SETADDR lun, mode , cylh, cyll , head , sector 

PARAMETERS: lun - Logical unit number (0-7). 

mode - Specifies th e address mode used (0 to 1): 

mode=0 => single vector 
mode=l -> 3-vector 

mode = -0 Interpret the remaining parameters as 
follows : 

cylh - High two bytes of six byte unsigned 
logical address. 

cyll - Middle two bytes of logical address. 

head - Low two bytes of logical address. 

sector - Disregarded. 

mode = 1 Interpret the remaining parameters as 
follows : 

cylh - The low byte of this parameter is used 
as the high byte of the three byte 
cylinder address (0 to 255). 

cyll - The low two bytes of the cylinder 
address. 

head - The low byte of this parameter is used 
as the one byte head address ( to 
255). 

sector- This parameter is used as a 16 bit 

unsigned integer which specifies the 
sector address. 
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OPERATION: This command will set the value of the target 
address to the value specified. The target address is 
also changed by the RDI, LOCRD, LOCWR, WDI, and 
SBLKDISP commands. The SETADDR command does not cause 
a seek, therefore the target address does not always 
reflect the physical position of the device. This 
can result in a situation where a RDI or WDI will 
cause a seek. 

EXAMPLE: >5000 DEV 0,7,3,1,0 

>5010 LENGTH 0,0,10000 

>5020 VOLUME 0,0 

>5030 SETADDR 0,1,0,1,1,2 

>50l*0 L0CVERI 

>5O50 END 
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SETOPTS 



FORMAL NAME: Set Options 
FUNCTION NAME: SETOPTS 



SYNTAX : 



> SETOPTS lun.p 



PARAMETERS: lun - Logical unit number (0 to 7)- 

p - This parameter byte is used to set 
device specific options (0 to 255)- 

OPERATION: This command is used to enable/disable device speci- 
fic capabilities. A description of the use of this 
command should be found in the documentation on each 
device. This command is not applicable to the 7935 - 
This is used to set various sparing modes with the 
CS/80 cartridge drive. 

EXAMPLE: >5000 DEV 0,7,2,1,0 
>5010 SETOPTS 0,0 
>5020 END 
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SETREL 



FORMAL NAME: 



Set Release 



FUNCTION NAME: SETREL 



SYNTAX: 



>SETREL lun.r 



PARAMETER: lun - Logical unit number (0 to 7). 

r - This parameter can have one of three 
values: 0, 64, or 128. 

OPERATION: Used to suppress the release timeout or automatic re- 
lease. The power on value is which will cause the 
device to request a release. The device will time out 
after two seconds and release itself if the host did 
not either grant the release or send another command. 
A value of 64 will set auto-release, that is the de- 
vice will release itself without requesting release 
following a two second idle period. A value of 128 
will suppress the release time-out, that is the de- 
vice will not release itself until granted release by 
the host. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 SETREL 0,64 
>5020 END 



4-36 



SLEUTH Simulator Diagnostic Language 



SETRETIM 



FORMAL NAME: Set Retry Time 

FUNCTION NAME: SETRETIM 

SYNTAX: > SETRETIM lun.tl 

PARAMETERS: lun - Logical unit number (0 to 7). 

tl - Specifies the retry time in 10 's of 
milliseconds (0 to 65535) - 

OPERATION: Retries are attempted after an uncorrectable data er- 
ror is encountered . The power-on value is equal to 
the optimal retry time specified by the Describe com- 
mand . A retry time of causes no retries to take 

place. 

EXAMPLE: >5000 DEV 0.7,3,1,0 
>5010 SETRETIM 0,10 
>5020 LENGTH 0,0,100 
>5030 LOCVER 0,1,0,100,1,55 
>50H0 END 
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SPAREBI.K 



FORMAL NAME: Spare Block 
FUNCTION NAME: SPAREBLK 



SYNTAX : 



>SPAREBLK lun.m 



PARAMETERS: lun - Logical unit number (0 to 7). 

m - This is the device specific mode byte 
(0 to 255)- For normal sparing m=0. 
Other values are device specific. 

OPERATION: This command allows the host to give the device per- 
mission to become temporarily busy while sparing the 
block indicated by the target address. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB BB.10 

>5020 SETADDR 0,1,0,100,5,50 
>5030 LENGTH 0.0,10000 
>5040 LOCVERI 
>5050 STATUS 0,BB{0) 
>5060 IF BB(3)<>6t THEN 5090 
>5070 SETADDR , 0,BB(5) ,BB(7 ) ,BB( 9) 
>5080 SPAREBLK 0,0 
>5O90 END 
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STATUS 



FORMAL NAME: Request Status 
FUNCTION NAME: STATUS 
SYNTAX: >STATUS lun,buf(0) 

PARAMETER: lun - Logical unit number (0 to 7). 
buf 



OPERATION: 



Buffer into which 20 bytes of status info 
is returned. 



This command returns 20 bytes of status information 
about the previous transaction. The Status command is 
a transaction itself, so issuing a STATUS command 
first returns the values in the status registers and 
then resets the status registers to reflect the com- 
pletion state of the status command. (Refer to Appen- 
dix C for a summary of the STATUS format.) 

NOTE 

Following a QSTAT of 1 or 2 on any command, 
a STATUS command is sent and this information 
outputs in an error message. 



EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 DB BB.10 
>5020 STATUS 0,BB(0) 
>5030 END 
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FORMAL NAME: 



Set Unit 



FUNCTION NAME: UNIT 

SYNTAX: >UNIT lun.n 

PARAMETERS: lun - Logical unit number (0 to 7)- 

n - Internal device unit number. (0 - 15) 

OPERATION: This command sends a CS/80 Unit command to the de- 
vice. The parameter n is sent with the Unit command 
to the device. The controller is always unit 15, the 
media of single unit devices is always unit 0. The 
DEV command sends a UNIT command to select the unit 
specified by the fifth parameter of that command. 

EXAMPLE: >5000 DEV 0,7,3,1,0 
>5010 UNIT 0,15 

>5020 RDI .will cause illegal 
>5030 END .op code error 
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VOLUME 



FORMAL NAME: Set Volume 

FUNCTION NAME: VOLUME 

SYNTAX: VOLUME lun,num 

PARAMETERS: lun - Logical unit number (.0 to 7). 

num - The volume nurober to be set (0 - 15)- 



OPERATION: 



EXAMPLE : 



This command will set the "set" value of volume to 
the value specified. Where appropriate fixed and 
removable storage are considered as seperate volumes. 
Some devices may have multiple removable volumes. 
This would be indicated by the DESCRIBE command. The 
power-on default is volume 0. 

>5000 DEV 0,7,3,1.0 

>5010 VOLUME 0,0 

>5020 LENGTH 0,0,500 

>5030 SETADDR 0,1,0,0,10,59 

>50«0 LOCVERI 
>5050 END 
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WDI 



FORMAL NAME: Write Data Immediate 

FUNCTION NAME : WDI 

SYNTAX: >WDI lun.buf(O) 

PARAMETERS: lun - Logical unit number (0 to 7). 

buf(0) - Buffer into which data is written. 

This parameter must be any buffer 
AA(0)-NN(0) where AA-NN define the 
buffer name and (0) sets an HF AID 
pointer to the first element in the 
buffer. 

OPERATION: This function will perform a seek and write to CS/80 
device. The buffer length determines the word count 
of the read. The address is the current target ad- 
dress which can be set with the SETADDK command . 

EXAMPLE: >5000 DEV 0,7,3.1,0 
>5010 DB AA.1024 
>5020 VOLUME 0,0 
>50«0 SETADDR 0,1,0,10,3,0 
>5050 WDI 0,AA(0) 
>5060 END 
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WFM 

FORMAL NAME: Write File Mark 

FUNCTION NAME: WFM 

SYNTAX: WFM lun 

PARAMETER: lun - Logical unit number (0 - 7). 

OPERATION: Writes a file mark (EOF) on CS/80 tapes only. 
Not applicatable to CS/80 discs. 

EXAMPLE: >5000 DEV 1,7,3,1.0 
>5010 DB AA, 10211 

>5020 RDB AA(0),1021 .Randomize Data Buffer 
>5030 LOCWR 1,AA(0),1,0,3,6,37 
>50M0 WFM 1 
>5O50 END 
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The following lists those buffers and variables reserved for use 
by the Sleuth Simulator functions along with a brief explanation 
of assignment. 

BUFFER USAGE 

00 RESERVED 

pp STATUS information for CS/80 devices 

qq DESCRIBE information for CS/80 devices 

rr Contains Magnetic tape and line printer commands. 

SS Contains status command and information as follows : 

Last status in and 1 

Status request command in 2 

Expected status in 3 and 4 

Don't care masks in 5 and 6 

Printer status in 7 

HP 7970E Tape status in 8 and 9; ESTA in 10 - 15 

TT Contains disc syndrome information 

UU Channel program buffer for general usage 

W Channel program buffer primarily for obtaining disc 
address and other general usage. 

WW Used for passing commands and information - usage 
is as follows: 

= command 

1-3, 6-8, and 16 = command or information 

i| = disc cylinder information 

5 = Head and sector information 
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BUFFER USAGE 

9 * counter 

10 = DSJ information 

11 = Sleuthsm variable usage indicator 

12 - Not used 

13-15 = disc parameters (cyl,hd,sect) 

17 = SCB error count 

18 = suppress status flag 

19 ■ Pause on error flag 

20 = DSJ information 

21 » f of sect/cyl 

22 ■ command 

23 " cyl information 

21 = head and sector information 

25 = Head count for verify error 

26 Sector count for verify error 

27 = Next sector after verify error 

28 and 29 » internal disc address (head & sector) 

30-32 x beginning cylinder, head, and sector 
address for a read or verify 

33 » final head address 

3*t = final sector address 

35 » SOUT counter 

36 = Statnum (CS/80) 

37 = Packed (CS/80) 
38-6 byte (CS/80) 

39 = Disc address (CS/80) 
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BUFFER "SAGE 

140-49 = IS function line number 

50-59 = IS function cylinder number 

60-69 = DS function line number 

70-79 = DS function cylinder number 

80-89 ■ IT function line number 
90-99 = IT function head number 
100-109 = IT Function cylinder number 

110 = Length (CS/80) 

111 = Status command (CS/80) 

112-126 = Command buffer (CS/80) 

XX Channel program buffer that is variable in length 
and is built every time a channel program is 
executed. 

y Y CPVA buffer (See Appendix B in the 7906,7920,7925 

Verifier Manual for more information) . 

22 This buffer contains DEV function parameters as 
follows: 

USAGE 

Initially variables - Z act as pointers to set up 
the logical unit table. This table contains all 
necessary parameters for a particular device usage 
and is located in buffer ZZ . Once the variable in- 
formation stored in buffer ZZ, all are then avail- 
able for general usage by the Sleuth simulator 
functions . 

NOTE: Attempted use of these variables by a user 
will adversely affect the users program. 

V 0-7 = Logical unit number 

8 = Ripple print counter 

9 = Printer page length counter 
W 10-17 = Channel number 
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BUFFER USAGE 

18 = Identify code of executing device 

19 = FMT cyl counter 
X 20-27 ■ device number 

28 = number of bytes per page (WD function) 

29 ■ Data overrun counter for 12745A 
Y 30-37 * number of errors 

38 » Top of form indicator (WD function) 

39 ■ Number of characters to be printed on the 

next page for the WD function. 

Z H0-H7 » Unit number 

50-57 ■ EXP status 2 word 

P 60-67 - Mask words 

Q 70-77 • 13037 disc type/Return addr mode for CS/80 

R 80-67 * device indentification code 

98-100 » HP 7976 LDEV STATUS 

101-103 - HP 7976 LDEV 1 STATUS 

1011-106 « HP 7976 LDEV 2 STATUS 

107-109 - HP 7976 LDEV 3 STATUS 

110-112 - HP 7976 LDEV i| STATUS 

113-115 » HP 7976 LDEV 5 STATUS 

116-118 = HP 7976 LDEV 6 STATUS 

119-121 ■ HP 7976 LDEV 7 STATUS 
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STRING BUFFER USAGE 

&W Print buffer CS/80 

&WW RESERVED 

&XX RESERVED 

&YY Print buffer 

&ZZ Contains information for user error reporting as 
follows : 

= variable name 

1-2 = buffer name 



A-5/A-6 



ii 



E 
E 

d> 
I 3 

U ui 

1 „» 

o at 



J 2 

2 % 



o £ 

o "5 

3 3 

? 5 

E E 

3 3 

§ I 



I * 

> -o 

u 

If 



E £ 

i i 



S S S S U 

" * W 

m to — 

> , > > ■ 

.".in 

> > > > > 



5|i 

If? 
*>. 

Hf 

& ™ 3 - 

S*a S 

«,x S 

3 ^ X ° 






I 

Sal 

O -O S 3 * x o 

Oo-r*. O c£ Z 



[! 



Si 

52 

E S 
c o 

- « 



IS 

is 

= : 
si 

So 

•S 



s: I 



* 

i I 

i ! 

3 m 

? ? 

£ .3oi 



g 1 as 

* 8 • I 

= * * 5 

Iris 

sis! w , o 

cjt; S». 1 

| i I * * S3SI 

•0«-D S ^, « 3 

- r i s s e| ;• 
If: I if* if 
I-M f ?i M 

3 § • 9 2 5 * E* 



— O lO 



59 



- si* 

52 Sl| 
1 1 \\\ 

3 • is * c £ 

£ ■= j S t o 



: »C ! 



CS/80 STATUS COMMJ 



ERROR REPORTING FIELDS 



FAULT ERRORS 



23 24 

(617 19 22 0} <24 26 27 26 30 31' 



AAA A 

A 



A' 

A 



A 



'AA 



ERROR 

was received wfh- 



>rnd« was received 



OS 

tun urnr, vorumr, 
M aUoned 1 nr 

TER 



* h» been violated 
ny reject or fault 
prior to sequence 



raw default «**. 



CROSS-UNIT 

(Unmaskabte Erroi) 

An error has octur;ed during a Copy Data 

operation. 

Parametei = 6 bytes, each byte contains 

The encoded »*iue ol a unrt which has 

experienced on error I- 1 indicates no 



aoViii! 



r.ti I 



CONTROLLER FAULT 

{ Unmask able Error I 

A nartJware taut* occurred >n me 

cofWoHer 

UMT FAULT 

I UnnvwkjblC Error) 

A hardware taurt has occurred m the 
unii addressed 

DIAGNOSTIC RESULT 

I Unmask able Error) 

Tne harrjware la»ied me d>agnosi>c indi- 
cated in the parameter herd 
Paiafneier 6 bytes 

RELEASE REQUIRED 

I Unmaskable Errors} 

This command cannot Be executed unt.i 

alter release rs granted to the device 

Device requires release tor indicated 



OPERATOR REQUEST 

Release required tor operator request 

(eg. load/unload, restore) 

DIAGNOSTIC REQUEST 

Release required for diagnostics initialed 
trom control panel (e.g , HIO. Mil W»). 

INTERNAL MAINTENANCE 

Release required tor internal rnainte 
nance !i.g.. he«j alignment, error logl 



POWER FAR. 

(Unmaskablc Error) 

The power io the unrt laded a thagnostK 
destroyed confcguratori or a pack was 
loaded Device should be recorAgured 

RETRANSMIT 

lUnmaskabre Crro<) 

The preceding Transaction should be 

retried 



ACCESS ERRORS 
HELD 



32 39 40 47 

(32 33 34 35 36 370 0) ;40 41 43 44 0) 



A 



ILLEGAL PARALLEL OPERATION 

The requested operation cannot be 
executed in parallel with tome other 
operation's) currenlly in progress. 

UNINITIALIZED MEDIA 

The host attempted to access unformatted 

media, or unusable media has been loaded. 



NO SPARES AVAS LASLE 

Spare block cannot be executed due K 
lack of spare media. 



The selected unit is not ready tor accei 
a! this lime (eg., heads or media not 

yet fully loaded) 

WRITE PROTECT 

The- selected volume is write protected 

NO DATA FOUND 



UNRECOVERABLE DATA OVERFLOW 

Tne previous transaction generaied mc*e 
than i unrecoverable data error The 
entire Iransler should be considered m 



UNRECOVERABLE DATA 

Unrecoverable data at mocaied wock(s) 
Parameter 6 bytes, address ol bad 
block 



(4849 50 51 52 55) (0 57 58 59 61 0) 



A 



AA 



END OF VOLUME 

The hosJ attempted t 
volume boundary 



REQUEST RELEASE 

Device requests release tor indicate* 



- OPERATOR REQUEST 

Release requested tor operator requei 
(e.g.. load/unload, restore). 

- DIAGNOSTIC REQUEST 

Release request initialed Iron diagna 
control panel (e.g.. HIO, self test). 

• INTERNAL MAINTENANCE 

Release requested for internal mainte- 
nance le.O,. head alignment, error togl 

- MEDIA WEAR 

Only one spare track (disc) or one 
spare block (tape! remaining. 

- AUTO SPARING INVOKED 



A defective block has been 
spared by the device 

* RECOVERABLE DATA OVERFLOW 

The previous transaction generated ( 
than 1 recover aoie data error 

x MARGINAL DATA 

Data was recovered, but with drHicu* 
Parameter « 6 bytes, address of btoc* 

* RECOVERABLE DATA 

A latency was mfcoducad m order lo 

correct a data error 

Parameter 6by1rs.rtfc*»»ofrecov 

block 
- MAINTENANCE TRACK OVERFLC 
Error and taull log area is tuft. 
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Parameter *eU confcguraaon s depeneerri on re- 
ported errors. 

Highest pnonty « grven » towwl numbered errors 
Washed errors re*nqutsh the* priorny 



IALI2ED MEDIA 

t attempted 10 access unformatted 
» unusable media h** been loaded. 



.RES AVAILABLE 

ock cannot be executed due 

ipare media. 



tied uml it no: leady tor access 
ime le.o.. beads or media not 

, loaded) . 

PROTECT 

Kited volume it write protected 
TA FOUND 



QVERABLE DATA OVERFLOW 

;vious Iransaei'Ofl generated more 
pnrecoveiaDle data enw The 
ansiet should be considered m 



OVERABLE DATA 

lerabie data at mttcated btoch(s) 
tier 6 bytes, address o> bad 



If FILE 

Me encountered on fie structured 



f VOLUME 
boundary 



INTERNAL MAINTENANCE 



Release requested for internal mainte- 
nance (e-S-. head alignment, error tool 

- MEDIA WEAR 

Only one spare track (dtscr or one 
spare Mock (tape) remaining. 

- AUTO SPARING INVOKED 

A detective block has been automat wally 
spared by the device 

= RECOVERABLE DATA OVERFLOW 

The previous transaefcon generated mar* 
than 1 recoverable data error 

T MARGINAL DATA 

Data was recovered, but wrrttl rJitficultv. 
Parameter - 6 bytes, address at Mock. 

* RECOVERABLE DATA 

A latency was introduced *t order to 

correct a data error 

Parameter 6 bytes, address o* recovered 

block 

« MAINTENANCE TRACK OVERFLOW 

Error and fault log area n furl 



No Errors: Pi through Pe indicate new Target Address. 
P? through Pio contain fault log consisting ot device 
specific information, except after Spare Block command 

After Spare Stock command. Pi through P« contain 
address of affected area. 

After Spare Stock command. Pi through Pio indicate 
length of affected field 

Error Bit No. IT 

Crott-yort: P> through P» contain the encoded value of 
each unit which has experienced an error (All ones 
indicate no additional units. I 

Error Bit No 24 

Diagnostic Results: Pi through Pe, indicate results of 

internal diagnostic (format is device dependent! 

Error 8.1 No 4) 

Unrecoverable Data: Pi through Pc indicate address of 

bad Mock 

Bit No. 48 - No. 50 

■ass: Pi through Pe contain the numbers 
ol those units requesting release. I All ones indicate 
no additional units ) 

Error Bit No. 58 

Marginal Data: Pi through Pe indicate address of the 

marginal block 

Error Bit No 59 

Racoterable Data: Pi through P* indicate address of 

recoverable block 
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1.0 INTRODUCTION 

The IOMAP utility has three purposes: 

(1) It provides a display of the system physical I/O 
configuration 

(2) It checks out the basic hardware I/O system 

(3) It provides Identify , Remote Self -Test, and HP-IB Loopback 
device tests. 

All channels on the 1MB are identified. The HP-IB Identify fea- 
ture is then used to obtain the ID codes for the devices con- 
nected to each GIC. Section V provides a list of those identify 
codes that are recognized by IOMAP. 

This identification process tells you that: 

(1) the I/O system (1MB and HP-IBs) is fundamentally working 

(2) no two channels and devices have the same address 

(3) the expected channels and devices are present and correctly 
configured. 

In addition to the I/O configuration display, IOMAP has three 
selectable test sections available to the operator when in the 
optional mode. This optional operating mode allows you to per- 
form Identify, Remote Self-Test, and HP-IB Loopback tests on 
selected devices. For intermittent problems, any one of these 
functions can be looped. 

This program is written in the AID language. 

1.1 REQUIRED HARDWARE 

An HP3000 HP-IB version system with 128 kbytes of memory. 

1.2 REQUIRED SOFTWARE 

Diagnostic/Utility System disc or tape. 
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1.3 LIMITATIONS 

Channel identification depends on correct operation of the 1MB 
and the CPU's ability to read the Configuration Registers of 
channels. This involves circuitry on every board connected to 
the 1MB; not just those explicitly involved in the transaction. 

Device identification depends on correct operation of the HP-IB 
which this involves circuitry in every device connected to the 
bus; not just the controller and device being identifified. 
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OPERATING INSTRUCTIONS I I t 

I I II I 



2.0 INTRODUCTION 

This section provides detailed instructions for loading and 
running the CS80 Device Diagnostic "CS80DIAG". 

2.1 CS80DIAG OPERATING PROCEDURE 

a. Have the SYSTEM OPERATOR do a system backup and 
then do an MPE SHUTDOWN. 

b. Mount the DUS tape or floppy and load the DUS program. 

c . Once the DUS program has output its title message 
and prompt ( : ) enter the following : 

:(CS80DIAG) 

d. The response will be: 

CS/80 Offline Diagnostic Program (revision n.nn) 

NOTE: If the diagnostic did not find any CS/80 devices, 

the following message is printed and the diagnostic 

will end. 

NO CS/80 DEVICES WERE FOUND. 
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Otherwise a CS80 device IOMAP will be output: 
CS/80 Device Configuration 



1MB number n 

Channel n ID=!0 General I/O Channel (GIC) 
Device n ID=!nnnn device name 



NOTE: At this point if there is more than one 
CS/80 device present then the following 
two questions are asked. The first question 
is asked only on multiple 1MB systems. 

Input the 1MB number of the device to test (0-2)? 
? 

(n) 
Input the Channel and Device number of the device 
you wish to test (1-15,0-7) ? 
? 

(nn,n) 

Default Sections are 1-1. Type "GO" to continue. 



NOTE: Possible inputs are: 

(loop) 

(test [♦ or -] [X[[/Y],Z]J ) 

(test all) 

(GO or GO 1) 

The loop command will cause the test 
to loop through the selected sections 
until control Y halts the program. At 
the end of each loop the program will 
print a message that the n'th loop has 
completed. Use loopoff to undo the 
loop command. 

The test command allows the user to 
select which sections to execute. The 
parameters allow a list of sections 
to be selected, or to add or substract 
sections from the already selected ones . 



Section 


1: 


GIC test 


Section 


2: 


Loopback test 


Section 


3: 


Selftest 


Section 


11: 


Status test 


Section 


5: 


System Type test 


Section 


6: 


External Exerciser 
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Sample I/O table (with tape unit offline or not selected) 



jOHAP SYSTEM I/O CONFIGURATION 

"Control panel switch settings: Channel=6 Device=2 
"System console is device on channel 1 

Channel 1 ID=!1 Async . Data Comm. Channel (ADDC) 
Device 0-3 ID=!l)080 Devices on ADCC MAIN (C0DE= 1,2) .^ 

Channel 5 ID=!° General I/O Channel (QIC) , rmF .,v 

Device ID=!l83 7970E Mag Tape Controller (C0DE-2) 

Unit i 7970E not on line or unit not selected 

Device 7 ID= 12001 2608 Dot Matrix Printer 

Channel^ ID=!0 General I/O Channel (GIC) 

Device 1 ID=!2 7906/7920/7925 Disc Controller (C0DE-2) 

Unit 7920 Disc Drive 

Device 2 ID=!81 7902 Flexible Disc Unit (Double-sided) 

Channel 7 ID= ! General 1/0 Channel (GIC) 
Device 7 ID=!200H 2680 Page Printer 

End of pass n 
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Sample I/O table (with tape unit on line and selected) 



IOMAP 



SYSTEM I/O CONFIGURATION 



"Control panel switch settings: Channel=6 Device=2 
"System console is device on channel 1 



Channel 1 ID=!1 

Devices 0-3 ID=!iJ080 



Async. Data Comm. Channel 
Devices on ADCC MAIN 



( ADCC ) 
(CODE=l,2) 



Channel 5 ID=!0 
Device ID=!183 
Unit 
Device 7 ID= 12001 



General I/O Channel (GIC) 
7970E Mag Tape Controller 
7970E Mag Tape Drive 
2608 Dot Matrix Printer 



(C0DE=2) 



Channel 6 ID=!0 
Device 1 ID=!2 

Unit 
Device 2 ID=!8l 



General I/O Channel (GIC) 

7906/7920/7925 Disc Controller (C0DE=2) 

7920 Disc Drive 

7902 Flexible Disc Unit (Double-side 



Channel 7 ID=!0 General I/O Channel (GIC) 
Device 7 ID=!200H 2680 Page Printer 

End of pass n 

Note: The devices on the ADCC HAlN and ADCC EXTEND are not 

individually identifiable. The ADCC responds to IDENTIFY 
command with !4080. 

Code: 1 Implies -- No Loopback 

2 Implies — No Self-Test 

3 Implies -- Loopback And Self Test Are Only Available 

In The Present Diagnostic 



point . 



indicates the number of passes that have been made to this 
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TEST DESCRIPTIONS I I """"""! 



30 INTRODUCTION 

The following paragraphs describe each test section operation and 
possible error situations and messages. 

3.1 TEST SECTION 1 - I/O CONFIGURATION TABLE 

The program performs the following sequence for each channel. 
(1, Perform Roll Call on the 1MB for specific channel type 

(2) Read Register of the channel 

(3) Perform ID sequence on the channel's HP-IB. 
32 TEST SECTION 2 - IDENTIFY 

Test Section 2: 

TEST SECTION 2 — IDENTIFY 

7 

The AID prompt character '7', awaits the operator's response: 
Upon entry of a legal channel and device number the test executes 
Upon entry of '-2' the utility returns the operator to: 
"IOMAP REVISION XX. XX" 

Fnter 'GO' to continue . 

'G0.1' to continue with printer output 

To ^"L^Ptio'na! UttTons with printer output 
('LC to list Commands) 
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►x^TnwJ 1 "?,^! operator may enter the 'TEST' and RETURN to exit 
the IOMAP utility, select another test section, or enter 'GO' to 
continue. 

33 TEST SECTION 3 - SELF-TEST 

In this test section, the following sequence is sent to a 
selected channel/device: 

Initiate Self-Test, read self -test results, and display self -test 
results. Test Section 3 begins with the following title and 
question: 

TEST SECTION 3 SELF-TEST 

Function: To Invoke Self -Test . 

Enter channel and device number separated by a comma 
or enter -2 to exit this test section. 



The AID prompt character, '?', awaits the operator's response 
Upon entering a legal channel/device number execution of this 
test section begins. (Entering a -2 causes same reaction as 
described in Test Section 2). The Self-Test results are dis- 
played upon completion of the test section. The results 
displayed on the first pass are used as the basis for -^par^ng 
subsequent pass results. On the first pass through this "section 
the following message is displayed: 

Initial Self-Test Results - IXXXX 

On subsequent passes the following message is displayed: 

New Self-Test Result Equivalent to Initial Result of XXXX 

or, 

Self-Test Results changed on Pass X, expected 'XXXX 
Received 'XXXX. 

NOTE: Not all devices will have Self -Test Capability. 
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3.4 TEST SECTIONS i - HP-IB LOOPBACK 

This test section attempts the HP-IB loopback function on 
selected channel/device. This test section begins as follows: 

TEST SECTION It LOOPBACK 

Function: To perforin the Loopback test. Enter a channel and 
device number separated by a comma or, Enter -2 to 



exit tnis test section. 



The AID prompt character, '?', awaits the operator's response. 

Upon entering a legal channel and device number this test section 
begins execution. (Entering a -2 causes the same reaction as 
described in Test Section 2). Upon completion of this test, the 
following is displayed: 

LOOPBACK TEST HAS COMPLETED 



LOOPBACK ERROR: PASS X BYTE A 
Received !D sent !C 
LOOPBACK Test has completed. 

Note 1: Not all devices have loopback capability. 

Note 2: Loopback is not allowed for the device acting 
as system console. 
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4.0 INTRODUCTION 

The following paragraphs describe possible error situations and 
corrective action. 



4.1 I/O TABLE ERRORS 

If a device responds with an ID code not recognized, the follow- 
ing message is displayed in the description field of the I/O con- 
figuration list. 

"Device responds but ID code undefined." 
Possible causes: 

(1) Device is not responding with correct ID code. Look up cor- 
rect code in Section V.2; check for stuck bits. 

(2) Device is not supported on system. Check current Configura- 
tion Guide brochure. 

(3) Device is newly supported on system and IOMAP program copy 
not up-to-date. 



A non-recognized channel type will cause the following message: 
"ID=!XXXX "Undefined Channel ID code." 
XXXX= ID code of channel. 

Possible causes: 

(1) Operator error. 

(2) Channel is identifying incorrectly. Look up correct code 
Section V.2; check for stuck bits. 

(3) Channel is newly supported on system and IOMAP copy is 
up-to-date. 



*2 OPTIONAL MODE ERRORS 

"Device X does not exist on Channel Y." 
"Enter a channel and device number separated by a comma, or 
Enter '100' to run IOMAP again. 



The AID prompt character, '?', awaits the operator's response. 
Each test section will stay in this loop (requesting entry of a 
channel and device number} until a legal channel and device num- 
ber has been entered. The three Optional Test Sections are 
described in detail in Section III. 

Possible causes: 

(1) Operator error. 

(2) Channel or Device is intermittently failing to Identify. 
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50 INTRODUCTION 

This section may be used as a quick reference identify codes 
recognized and supported by an HP 3000 or HP-IB version computer 
system. 

51 SUPPORTED CHANNELS 

IOMAP currently recognizes the following channels: 

GIC 

ADCC MAIN 

ADCC MAIN with EXTENDER 



SI SUPPORTED DEVICES 

IOMAP currently recognizes the following devices: 

ID code DEVICE 

! 0081. .. .7902 Flexible Disc Drive 

10001 7910 Fixed Disc 

10082 127H5 HP-IB Adapter for 13037 Disc Controller 

!2001 2608 Line Printer 

12002 2631 Serial Printer 

12080. .. .Integrated Display System (IDS) 

1H080 ADCC 

16000.... QIC as device 
18000.. . .PMPI 
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JO INTRODUCTION 

Command Set 80 (CS80) is a message oriented protocol that builds 
messages into transactions. Thus providing a channel independent 
structure for exchanging commands, data, and status information 
between the CPU and CS80 devices. 

The HP 3000 CS80 Device Diagnostic (CS80DIAG) is designed to 
accomplish the following: 

o Determine the system I/O configuration 
o Test the GIC registers and interrupts 
o Run loopback tests, to check the HPIB data path 
o Run CS80 device selftests 

o Run status tests (cause errors and check status) 
o Do common system operations, read, write... 
o Implement the CS80 device External Exerciser (refer to 
Appendix A) 

1.1 HARDWARE REQUIREMENTS 

The hardware required for this diagnostic is an HP 3000 HP-IB 
version computer system, a device from which to cold load the 
Diagnostic Utility System (DUS), and the device to be tested. 

1.2 SOFTWARE REQUIREMENTS 

This diagnostic requires DUS and AID (a diagnostic language that 
resides under DUS). 
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1.3 CS80DIAG CONVENTIONS 

This document uses various special conventions to make it easier 
to understand and use. The conventions used are: 

Inputs required by the diagnostic will be shown in parenthesis 
ie., (loop), (test all), etc. Questions output by the diagnos- 
tic will be terminated by a question mark (?), followed by an 
input prompt of a question mark (?) or a greater than (>) sign. 

The characters 'nnnn' will be used to describe any number, but 
does not denote the number of digits in that number. Notations 
such as 'nn', or 'n' does denote the number of digits in that 
number. The character 'm' will be used at times to denote a 
digit that is different from 'n' . The characters 'HHHHH' will 
be used for outputs displayed in HEX. 



1.4 MINI-OPERATING INSTRUCTIONS 

+ 

1. Perform an MPE 'SHUTDOWN 1 . 

2. Cold load the Diagnostic/Utility System. 

3. Once the DUS program has output its title message 
and prompt ( : ) enter "CS80DIAG" 

J4. The response should be: 

Program Loaded ! ! 
nnnn> 

The CS80DIAG is now loaded and may be run with 
the "RUN" command. 

+ _^ 
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2.0 INTRODUCTION 

The following paragraphs describe the method used to load 
execute the standard operation for IOMAP. Also described is 
optional operating modes of the IOMAP program. 

2 1 STANDARD MODE OF OPERATION 

Perform the following steps to obtain a listing of the current 
I/O configuration of the system. 

1. Load the Diagnostic/Utility System flexible disc or tape per 
the procedure found in the Diagnostic /Utility System Manual. 

2. Once the DUS has displayed its title message and prompt, en- 
ter IOMAP and then press RETURN. IOMAP will respond with its 
title message and prompt as shown below: 

IOMAP REVISION XX . XX 

Enter 'GO' to continue 

'G0,1' to continue with printer output 

'GO 1' for Optional Test Sections 

'GO 1,1' to run Optional Sections with printer out 

('LC to list Commands) 
> 

3. Enter GO' or 'G0,1' and the IOMAP program will do an ident- 
ify to all devices and then display the system I/O configur- 
ation table, as shown on page 2-3, and then return control to 
DUS. 

11 OPTIONAL MODE OF OPERATION 

In addition to the I/O configuration display, IOMAP has three 
selectable test secions available to the operator when in the 
optional mode. 
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Each of the optional test sections will request the operator to 
enter a channel and the device number. After the operator enters 
a legal channel and device number and execution of the selected 
test section completes, the operator will be returned to the 
entry point of the selected test section. The request for a 
channel and device number only occurs on the first pass through 
the optional test sections. Therefore, entering the AID 'LOOP' 
command, does not force the operator to re-enter the desired 
channel and device number as each pass is made. 



To enter the optional mode, enter 'GO 1' or 'GO 
response, the system displays the following message: 



1,1' 



In 



IOMAP 

Test Section 2 
Test Section 3 
Test Section 1 

Enter Desired Test Section(s) 

( ' LC ' to list commands) 



Optional Test Sections 

Identify 

Self-Test 

Loopback 



At this point you enter the term 'TEST' and then the test section 
number that you want to execute. For example: Entering 'TEST 2' 
will execute the Identify portion of the IOMAP program. 

NOTE: To exit the Optional Mode of operation, enter TEST' 
with out a test section number and the GO' selections will be 
displayed again. 

2.3 MESSACES 

Several kinds of messages may be displayed by IOMAP: 

General messages: Request action from the operator or report 
results of commands. 



Response to the operator's requested func- 
tion was not expected or operator entered 
incorrect information in a command. 

I/O table All responding channels and devices are 

displayed in ascending order asccording to 
their respective channel address (CHAN ADDR 
switch position) and. device s^Hres??? (DE- 
VICE ADDR switch position). 
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Both the loop and the test commands will 
be followed by the greater than prompt . 
Thus commands could be changed or canceled . 

The GO command will cause the diagnostic to 
continue . 

GO Execute the tests and direct 

the output to the terminal. 



GO 1 



Execute the tests and direct 
the output to the printer. 



NOTE: Each section selected will then execute. 
If the Loop command was used the 
following will then be printed. The looping 
will continue until control "Y" is entered. 
The break -mode prompt (>) will then be 
displayed and "EXIT" can be entered to 
terminate the program. 

Start of Section n [test name] 

End of Section n 

Start of Section m [test name] 

End of Section m 

End of pass 1 

Start of Section n [test name] 

(control Y) 

Break in statement nnnn 

> 

(EXIT) 

End of AID user program 
nnnn> 

NOTE: If the Loop command was not used the 
following will be printed. 



Start of Section n 
End of Section n 
Start of Section m 
End of Section m 
End of pass 1 



[test name] 
[test name] 



NOTE: If the default sections are selected then 

the program will end after the test complete 
message. 

End of Program 

NOTE: Or if the default sections were not selected 

then the program will branch to the point where 
sections can be selected. 

Default Sections are 1-4. Type "GO" to continue. 
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2.2 USER INTERFACE WITH TEST SECTIONS 



Test sections 1 through 5 do not prompt for any inputs and do not 
output messages except start/stop and error messages. A pause 
will follow each test step, that was not successful, to allow the 
user to look at the Status Buffer (PP) by entering the following: 

>LIST B,PP 

The command SNPS may be used to disable these pauses. 

Section 6 is highly interactive. It is described in Appendix A. 

2.3 EXECUTION TIMES 

Test sections 1 thru 5 will execute in less than 3 minutes per 
section, assuming no errors are detected. Test section 6 will 
take a variable amount of time depending on the test, device and 
the CPU. 
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3.0 INTRODUCTION 

This section describes each test section and all steps associated 
with it. Upon initialization of CS80DIAG an HP-IB roll call com- 
mand is issued to all GICs to determine which ones respond. An 
Identify command is then sent to each CS80 Device to determine 
its device code. Then an IOMAP of all CS80 devices is output. 



3.1 TEST DESCRIPTIONS 

Test Section 1 - GIC Test 

The GIC test will test all register except: 

Register 2, which contains bits that indicate 
PHI conditions, which may assert 
the PHI interrupt line. A Write 
will clear interrupt bits. 

Register B, A write to this register will start 
a DMA operation. 

Steps 1-9 Test of GIC registers 1-A. 

Testing consists of writing data to various bits in 
GIC registers , which will not cause any action to 
take place and reading the data back. The registers 
and bits affected are: 

Register 1: @S 

Register 3:0e-- eeee S@ee 

Register 4: eeee eeee 

Register 5: eeee eeee 

Register 6:0000 oooo eeee eeeo 

Register 7: eeee eeee 

Register 8: e@@@ eeee 

Register 9: eeee eeee eeee eeee 
Register a : eeee eeee eeee eeee 



e 



bits which will be tested. 

bits which a write instruction has no effect, 
bits which must be written with 0, so as not 
to affect other bits. 
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Step 10 Testing GIC register C. 

The read format for this register is different 
from the write format. Data is written and the 
value read back is compared with the value 
expected. 

Step 11,12,13 Testing GIC registers F,D and E. 

The read only registers are tested by comparing their 
contents against data which are formatted with known 
information. 

Step 11 Checking GIC switches 

the "sys Ctrl", "device type", "processor", and 
"diagnostic" switches are checked by looking at 
certain bits in GIC registers 1,B, and E. 

Step 15 Testing Inbound and Outbound FIFO. 

After the PHI is first taken offline, the 16 word 
FIFO is filled with data by writing to register 0. 

The 16 word data is read back via register 0, and 
compared with the original data. 

Step 16 Interrupts . 

Interrupts are tested by setting all bits in the 
interrupt mask to enable interrupts, setting bits 
12-15 in GIC register C appropriately to force an 
external interrupt, and using the aid reserved word 
BADINTP to detect and verify the interrupt. 

This test will work on any hardware configuration the 
system has. It is by no means a comprehensive test, 
rather it is a quick look test. 



Test Section 2 - Loopback Test 

The Loopback test section will perform a write 
loopback of 256 bytes of data using the following 
pattern 255,0,1,... to 251. Correct transmission 
will then be checked, followed by a read loopback 
of 256 bytes. This is then checked for validity. 

Step 20 Write Loopback. 

Step 21 Read Loopback. 



Test Section 3 - CS80 Device Selftests 
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The Selftest section will execute an initiate diag- 
nostic selftest command. This will cause the device's 
micro-code to perform its internal checks. 

Step 30 Selftest. 



Test Section 4 - Status Tests 

The Status test section will use illegal commands 
or illegal sequences to cause the following status 
bits to be set. 

Step 40 Illegal Opcode 

This status bit is set by building a channel 
program with an illegal opcode in the 
execution phase, (ex. read=0, write=2, 
illegal=l ) 

Step 41 Module Addressing 

This status bit is set by trying to access 
a non-exsistant unit using the set unit 
command. 

Step 42 Address Bounds 

This bit is set using both vector mode 
addressing and block mode addressing. 
The Set Address command is used to set an 
address greater than the maximum allowed by 
the device. 

Step 43 Parameter Bounds 

This status bit is set by issuing a mask 
status to mask all unmaskable bits in the 
status . 

Step 44 Illegal Parameter 

This status bit is set by issuing a command 
without parameters . 

Step 45 Message Sequence 

This status bit is set by using a Write 
command with a read execution phase. 

Step 46 Message Length 

This status bit is set by setting a length 
in the command phase, and using a different 
length in the execution phase. 
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After each error sequence has been performed the 
test will check that the correct status bits 
have been set. Only status bits in the Reject Errors 
Field will be tested, because the corresponding 
errors can be easily produced. 

Test Section 5 - Common System Operations 

The system tests will execute all the CS/80 
commands applicable to the device except for 
Initialize Media (Format) and Spare Block. 
Both of these are accessable in the External 
Exerciser section. The functionality of each 
command is tested as thoroughly as possible, 
but in some cases (Release, Release Denied...) 
it is not done thoroughly to keep the test 
automated. Commands common to both disc and tape 
are tested before device dependent commands. 

Step 60 Request Status 

Request Status is tested by issuing the command 
twice. The second status request command should 
return a status message with no error bits set. 

Step 61 Locate and Verify 

Locate and Verify is tested by issuing the command 
and checking the status for correct execution. The 
length of the verify will be 2K bytes. 

Step 62 Locate and Read 

Locate and Read is tested by issuing two reads from 
the same address and comparing the data retrieved. 

Step 63 Locate and Write 

Locate and Write is tested by writing data to an 
address and reading the data back. The retrieved 
data is compared with the original data for data 
integrity. User data is protected by issuing a 
read before this test and a write following it to 
save and restore the data. 

Step 6*1 Set Unit 

Set Unit is tested by issuing the command and check- 
ing that the UNIT field cf the status corresponds to 
the unit number set. This will be performed for more 
than one number. 

Step 65 Set Volume 
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Set Volume is tested in the same manner as Set Unit, 
except the volume bits in the first word will be 
checked. 

Step 66 Set Address 

Set Address is tested by issuing the command and 
checking the first six words in the parameter field 
of the status for the new address. It is checked in 
block and vector mode as allowed by the device. 

Step 67 Set Block Displacement 

Set Block Displacement is tested by obtaining the 
address from the parameter field of the status, 
adding the offset to the address, issuing the 
command, and then comparing the two values. 

Step 68 Set Length 

Set Length is tested by setting a length and building 
a channel program, not using the length complementary 
command, and checking buffer XX for correct length. 

Step 69 Set Burst 

Set Burst is tested by performing a read and write in 
burst mode. As in the write test, the user data is 
protected by reading the data before the test and 
writing it back following the test. 

Step 70 Set Status Mask 

Set Status Mask is tested by masking the address 
bounds bit of the status, forcing that error to occur 
and checking to see if that bit was set . 

Step 71 Set Return Address Mode 

Set Return Address Mode is tested by returning a par- 
ticular address first in block mode, then in vector 
mode, and verifying that the address conversion was 
correct . Another address is then set and returned 
in vector mode, converted to block mode, and again 
testing that the correct conversion was made. 

Step 72 Describe 

Describe is tested by comparing the bytes returned to 
a previously defined template. The template has the 
correct bytes that should have been returned. 

Step 73 Set Retry Time 



3-5 



CS80 Device Diagnostic 



Set Retry Time is tested by sending the command to 
set a time, performing a read, and then setting it 
back to its default. The self test section caused 
the device's microcode to test this feature intern- 
ally. 

Step 71 Identify 

Identify is tested by issuing the command and compar- 
ing it to the code previously obtained. 

Step 75 Release 

Release is tested by sending the command and checking 
the status for correct execution. 

Step 76 Release Denied 

Release Denied is tested by sending the command and 
checking the status for correct execution. 

Step 80 Write Pile Mark (tape only) 

Write File Mark is tested by writing data to an 
address followed by a file mark. It is checked by 
reading beyond the file mark and seeing if the End Of 
File bit in the status has been set . 

Step 90 Set Rotational Position Sensing (disc only) 

Set Rotational Position Sensing is tested by sending 
the command to set a value, performing a read, then 
setting the value back to its default. The Self test 
causes the device microcode to test this feature in- 
ternally. 



When this section is selected a warning is printed about 
the possibility of data corruption and that a scratch 
pack/tape should be mounted. Assuming no power fails, 
read/write errors, and successful program completion, 
the pack/tape will have the same data as before the 
start of the test. This is accomplished by preceeding 
every step, which writes data, with a read to preserve 
the original data in a buffer in memory. Then After 
the step has completed, this buffer is written back to 
restore the original data back on the pack/tape. 
If this protection read does not complete successfully, 
the test step will not continue. 
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Test Section 6 External Exerciser 



The External Exerciser section is an implementation of 
the External Exerciser designed by Disc Memory Division 
to execute the internal diagnostics of CS80 devices. 
Refer to Appendix A for information on the External 
Exerciser. 



3-7/3-8 



I I SECTION | 
ERROR MESSAGES I I I 



I I IV 



4.0 INTRODUCTION 

This section provides the user with the format used to present 
error messages encountered in each of the test sections. 



4.1 ERROR INTERPRETATION 

Start Section 1: GIC Test {all register names will be 

given in hex} 

Error in Step 1: GIC Register !1 is defective, 
data written to register %nnnnnn 
data read from register %nnnmnn 
NOTE: format will be used for registers 3-A. 

registers contain RAM like bits that can be 
written and read without affecting anything. 

Error in Step 10: GIC Register !C is defective, 
data written to register %nnnnnn 
data expected from register %nnnnnn 
data read from register innmnnn 
NOTE: read format is different from the write format 
for this register. 

Error in Step 11: GIC Register !F is defective, 
data expected from register %nnnnnn 
data read from register %nnnmnn 
NOTE: registers F, D, and E are read only. 

Error in Step 14 : Testing GIC switches 

' sys Ctrl' shows GIC not system controller 
'device type' switch is set to non-amigo devices 
'diagnostic' switch is set to 'test' 
'processor' switch is set to ' CPP ' 

Error in Step 15: Testing Inbound and Outbound FIFO. 
Error detected in word n, data returned %nnnmnn 

original data %nnnnnn 
{this will be written for all errors found} 

Error in Step 16: Interrupts are not working 

End of Section 1 
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Start Section 2: Loopback Test 

Error in Step 20: Write Loopback, n out of 256 bytes were 
written 
{ status } 

Error in Step 21: Read Loopback, n out of 256 bytes were read 

Error data detected at byte T, suspected error bit is Snnnnnn 
{this will be printed for the first 10 errors} 

End of Section 2 



Start Section 3: Self test 

Error in Step 30: Self test failed 

{ status ) 

{ Refer to paragraph H . 2 for the status format } 

End of Section 3 

Start Section 1: Status Test 

Error in Step 40: Illegal Opcode bit (5) is defective, 
{status} 

Error in Step 11: Module Addressing bit (6) is defective, 
{status} 

Error in Step 12: Address Bounds bit (7) is defective, 
{status} 

Error in Step 1)3: Parameter Bounds bit (8) is defective, 
{status} 

Error in Step M4 : Illegal Parameter bit (9) is defective, 
{status ) 

Error in Step 45: Message Sequence bit (10) is defective, 
{status} 

Error in Step 16: Message Length bit (12) is defective, 
{status} 

End of Section 1 

NOTE: Only status bits in the Reject Errors Field will be 
tested, because the corresponding errors can be 
easilv produced 
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Start Section 5- System Type Test 

Error in Step 60: Testing Request Status Command 
Returned from power fail. 

Error in Step 61: Testing Locate and Verify Command 
Error in function LOCVER 
{status} 

Error in Step 62: Testing Locate and Read Command 

Error in function LOCRD 

{status} 
n out of m bytes were read 

Error in Step 63: Testing Locate and Write Command 
Error in function LOCWR 
{status} 
n out of m bytes were written 

Error detected in word nn, data returned %nnnnmn 

original data %nnnnnn 
{this will be written for the first ten errors} 

Error in Step 64: Testing Set Unit Command 

Error in function UNIT 

{status} 

Expected Unit nn was mm 

Error in Step 65: Testing Set Volume Command 

Error in function VOLUME 

{status} 
Expected Volume n was m 

Error in Step 66: Testing Set Address Command 
Error in function SETADDR 
{status} 
Expected Block Address =nnnn 

OR 
Expected Vector Address = 
cyl =nnnn 
head =nnnn 
sect =nnnn 

Error in Step 67: Testing Set Block Displacement Command 
Error in function SBLKDISP 
{status} 
Expected Block Address =nnnn 

OR 
Expected Vector Address = 
cyl =nnnn 
head =nnnn 
sect =nnnn 

Error in Step 68: Testing Set Length Command 
Error in function LENGTH 
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(status) 
Expected length is nn 
Length actually used is mm 

Error in Step 69: Testing Set Burst Command 
Error in function BURST 
{status} 

Error in Step 70: Testing Set Status Mask Command 

Error in function MASKSTAT 

{status} 
Masked Address Bounds bit, but the bit was set. 

Error in Step 71: Testing Set Return Addressing Mode Command 
Error in function RETADMOD 
{status} 
Starting Vector Address = 

cyl=nnnn 

head =nnnn 

sect-nnnn 
Final Vector Address = 

cyl=nnnn 

head -nnnn 

sect-nnnn 
Starting Block Address nnnn 
Pinal Block Address nnnn 

Error in Step 72: Testing Describe Command 
Error in function DESCRIBE 
{status} 
Error found in word nn, data returned ytnnnnnn 

original data Xnnnmnn 
{this will be printed for all bytes in error } 

Error in Step 73: Testing Set Retry Time Command 
Error in function SETRETIM 
{status} 

Error in Step 7*t : Testing Identify Command 
Identification code returned Innnn 
Identification code expected immnrni 

Error in Step 75: Testing Release Command 
Error in function RELEASE 
(status) 

Error in Step 76: Testing Release Denied Command 
Error in function RELDEN 
{status} 

Error in Step 80: Testing Write File Mark Command (tape only) 

Error in function WFM 

{status} 
File Mark Not Found After reading n bytes . 
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Error in Step 90: Testing Set RPS Command (for disc only) 
Error in function RPS 
{status} 

End of Section 5 
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*Z ST ATI S FORMAT 

••IDENTIFICATION FIELD** 

Unit = nnnn Volume = nnnn 

No Units Require Service 

OR 
Unit nnnn Requires Service 

••REJECT ERRORS FIELD* * 

Channel Parity Error 
Illegal Opcode 

Illegal Volume or Unit number 
Address Bounds Error 
Parameter Bounds Error 
Illegal Parameter 
Message Sequence Error 
Message Length Error 

"FAULT ERRORS FIELD** 

Cross Unit Error during Copy Data 
Unit which had errors are: 
Unit = nnnn 
Unit = nnnn 
Controller Fault 
Unit Pault 

Hardware Failed Diagnostic 
Part number= nnnn failed 
Test Error number= nnnn returned 
Drive Error number= nnnn returned 
Release Required for Operator Maintenance 

before command can be executed 
Release Required for Diagnostics Maintenance 

before command can be executed 
Release Required for Internal Maintenance 

before command can be executed 
Power Failed or Drive just Powered On 
Auto Release has been completed / Retransmit command 

••ACCESS ERRORS FIELD** 

Illegal Parallel Operation 
Uninitialized Media 
No more spares available 
drive is not ready 
Volume is Write Protected 
No Data Found 

Unrecoverable Data Overflow 

Unrecoverable Data, Address of bad data follows: 
Block Address = nnnn 
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OR 
Vector Address 
cyl = nnnn 

head = nnnn 

sect - nnnn 
End of File encountered 
End of Volume encountered 

•'INFORMATION ERRORS FIELD** 

Operator is Requesting Release 
Release Requested for a Diagnostic Result 
Release Requested for Internal Maintenance 
Media Wear 

Latency Induced for Data Overun 
Auto Sparing Invoked by the Unit 
Recoverable Data Overflow 
Marginal Data encountered, data was 
recovered but with much 
difficulty. Address of marginal 
data is: 
Block Address = nnnn 

OR 

Vector Address 

cyl = nnnn 

head = nnnn 

sect = nnnn 

Recoverable Data — but a latency 

was induced in order to recover 
the data. Address of the recovered 
block is: 

Block Address - nnnn 

OR 

Vector Address 

cyl = nnnn 

head » nnnn 

sect = nnnn 

Maintenance Track Overflow 

New Target Address is : 
Block Address = nnnn 

OR 
Vector Address 

cyl = nnnn 

head ■ nnnn 

sect = nnnn 
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EXTERNAL EXERCISER 

SECTION I. GENERAL INFORMATION 

1-1. INTRODUCTION 

The CS/80 external exerciser is an interpreter which links the 
vast set of internal diagnostics and utilities within a CS/80 
peripheral to a service-trained person. 

The purpose of this manual is to aid service-trained personnel 
in troubleshooting CS/80 peripherals to a replaceable assembly 
level . 

1-2. SCOPE 

This appendix divides the external exerciser into three sec- 
tions: Section I is general information about what the CS/80 
external exerciser is and what it does. Section II contains the 
exerciser commands which include error rate tests, media 
initialization, and diagnostics; section III contains operator 
designed commands such as locate and read, locate and write, and 
compare. The service manual for the particular CS/80 peripheral 
being diagnosed should be consulted for a list of external exer- 
ciser commands which it supports, since some of the commands are 
designed specifically for certain devices. 

The complete documentation of the CS/80 instruction set can be 
found in the CS/80 Instruction Set Programming Manual, part num- 
ber 5955-3112. 



A-3 



CS80 Device Diagnostic 



1-3. ERROR RATE TESTS 

An error rate test finds uncorrectable and correctable read er- 
rors and accumulates information about each error, such as the 
address where the error occurred and the type of error which was 
found. Information obtained during error rate tests can be prin- 
ted out and/or logged on a portion of the disc reserved for in- 
ternal controller use. This area of the disc is the disc main- 
tenance track. Disc maintenance tracks provide non-volatile 
storage space for error rate test errors, spare track addresses, 
drive faults, and contain special worst case data patterns which 
are written on the disc for certain types of error rate tests. 
There are two general types of error rate tests: Read Only Error 
Rate Tests ( RO ERT) are nondestructive to data on the media; 
Write-Then-Read Error Rate Tests (WTR ERT) are destructive to 
the data on the media. 

A description of the two types of read only error rate tests (RO 
ERT) follow: 

A read only error rate test is a non-destructive error rate test 
which sequentially reads the current data over a specified area 
on the media and attempts to locate any read errors which may 
occur. 

Read only random error rate test is a non-destructive error rate 
test which will read 256 blocks of random lengths of the current 
data on the media at 256 random addresses and attempt to quickly 
locate any read errors which occur over a large area of the 
media by not being required to search sequentially through add- 
resses for errors. 

A description of the three types of Write-Then-Read Error Rate 
Tests (WTR ERT) follows: 

A pattern WTR ERT sequentially writes a specified data pattern 
over a specified area of the media and then reads all the data 
that was written in an attempt to locate any sensitive bit pat- 
tern errors as well as read errors or media defects. User data 
will be lost. 

A random WTR ERT will write-then-read 256 randomly generated 
data patterns of random length at random address locations. It 
will attempt to quickly locate sensitive bit pattern errors as 
well as read errors or media defects which occur over a large 
area of the media by not being required to search sequentially 
through addresses for errors. User data will be lost. 

The Short WTR ERT is a destructive error rate test which will 
execute a combination of a random error rate tests on the inner- 
most 100 cylinders. The short error rate test is intended for a 
quick verification of the media. User data will be lost. 
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All error rate tests allow a user to input a loop count which is 
used internally within the device when it executes the error 
rate tests. This loop count is a count of the number of passes 
that the device will execute during an error rate test. 

The write-then-read error rate tests allow the user to specify a 
data pattern containing 8 hex digits. This pattern may be enter- 
ed in hexadecimal form only. If the pattern entered is not 8 
digits the pattern will be right justified in a 32 bit field for 
the error rate test. 

When the error rate test encounters a data error, it will stop, 
report the error, and then resume the error rate test until the 
loop count has been satisfied. 

The error rate test reports the following information about the 
errors which occur during the error rate tests; 

1. An error information byte. 

2. The error rate internal loop count when the error occurred. 

3. The current physical address of the drive. 
U . The current logical address of the drive. 

5. The byte number at which the error begins at. 

6. An error bit map of the specific data bits which were in 
error . 

The user has three options for logging data errors which occur. 
These are described below: 

The user may print all the information described above so that 
the external exerciser will print the first byte in the sector 
which was in error along with the byte preceeding the error byte 
and the byte following the error byte. An exception to this will 
be the condition where the first byte or last byte failed. The 
exerciser will inhibit printing the previous byte or following 
byte respectively. 

The user may print all the information described above except 
for items number 5 and 6. 

The user may log all the information described above in the 
drive's internal error rate log except for items number 5 and 6. 
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1-4. ERROR LOGGING 

An area in RAM is used during run-time to record up to 5 uncor- 
rectable data errors. During an error rate test, the the same 
memory space in RAM is used to record any data errors if found . 
If this area in RAM becomes full during run-time, the drive re- 
quests release in order to log the error information or. the disc 
maintenance tracks. Logging to the maintenance track is handled 
automatically by the disc. The run-time data error log contains 
information about data errors found only during run-time. During 
run-time, the error correction circuitry is enabled. If the er- 
ror correction circuitry can correct an error, it will not be 
logged during run-time. Error rate tests, however, disable the 
error correction circuitry which allows any type of error to be 
logged . 
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EXTERNAL EXERCISER 
SECTION II. EXERCISER COMMANDS 

2-1. COMMAND FORMAT 

The commands listed in this section are in alphabetical order. 
The following format is used for each command : 

COMMAND NAME 

SHORT DEFINITION 

Explanation of what the command does and when it should be used. 

INPUT FORMAT: 

Input the test name? 
o 

COMMAND NAME 

OUTPUT FORMAT: 

WHAT IS PRINTED WHEN THE COMMAND HAS BEEN EXECUTED 
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2-2. CANCEL 

CANCEL COMMAND UTILITY 

This command causes graceful termination of some CS/80 
transactions leaving them in the reporting phase. Cancel is 
useful when an infinite loop or similar problem (excessive time 
delay) results while using the exerciser. 

INPUT FORMAT: 

Input the test name? 
7 

CANCEL 

OUTPUT FORMAT: 

CANCEL COMMAND UTILITY COMPLETED 
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2-3. CERT 

CERTIFICATION ERT TEST 

This command initiates a full certification to be done on the 
tape cartridge. 

INPUT FORMAT: 

Input test name? 
1 

CERT 

Input the loop count ; 

1 <= count <=254 or INF 

? 

[nnnn] 

This test will destroy current 

data. 

Should it continue? 

[YES] or [NO] 

Sources of the bit pattern are: 
PT = ERT internal Pattern Table 
UP = User inputs pattern table 
RN = ERT generates random 
pattern table 

Enter the pattern source? 
•> 

[PT] or [UP] or [RN] 

Input a HEXADECIMAL data 

data pattern (i.e. F2F) 

With a maximum of 8 HEX digits? 

1 

[HHHHHHHH] 

OUTPUT FORMAT: 

Do you want to see 

the ERT log? 

? 

[YES] or [NO] 

ERT LOG HEADER 



[NO] stops this utility. 



This appears for user input 
pattern only. 



If [YES] was entered. 



I OF BLOCKS ACCESSED « nnnnnnnn 
# OF BLOCKS CORRECTED = nnn 
due to Permanent s ■ nnn 
due to Transients « nnn 
t OF UNCORRECTABLE BLOCKS = nnnn 

u r\T* ttvtt r\s* » m * Dt P Bt A/*tf(! — «-_-*.* 
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Logical Addresses Errors 

nnnnnn UNLOCATABLE 

nnnnnn UNCORRECTABLE 

nnnnnn UNLOCATABLE 

Until all errors are displayed. 

CERTIFICATION TEST UTILITY 
COMPLETE 
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2-4. CHANNEL 

HP-IB CHANNEL TEST UTILITY 

This command initiates a READ and WRITE loopback test on the 
HP-IB channel. 

INPUT FORMAT: 



Input the test name? 
? 

CHANNEL 

Current HPIB device 

address = nnnn 

Do you want to test another 

HPIB device address? 

o 

[YES] or [NO] 

Enter the HPIB device address? 

1 

[nnnn] 

OUTPUT FORMAT: 

READ LOOPBACK TEST PASSED 

CS'80 WRITE LOOPBACK TEST 
PASSED, CHANNEL TEST SUCCESSFUL 

ERROR during READ LOOP BACK 

Byte was HH 

Should have been HH 

Command set '80 READ LOOP BACK 

test failed while receiving 

data from the device. 

Not enough data bytes sent . 

Received nnnn 

Expected 1024 



[YES] asks for user 
to input the address. 



If channel test is 
successful . 



For each bad byte. 



If less than 1024 
bytes were received. 



Command set '80 WRITE LOOP BACK 
test failed while sending 
data to the device. 
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2-5 CICLEAR 

CHANNEL INDEPENDENT CLEAR 

This command allows the exerciser to clear any channel connected 
to the device. 

INPUT FORMAT: 

Input the test name? 

? 

CICLEAR 

OUTPUT FORMAT: 

CHANNEL INDEPENDENT CLEAR 
UTILITY COMPLETED 



A-12 



CS80 Device Diagnostic 



1-6. CLEAR LOGS 

This command is used to initialize the run time data error log, 
the error rate test log, and the drive run time fault logs. 
Initializing the logs removes any previously accumulated error 
information from the logs. 

The user has the option of clearing only the error rate test log 
which allows logging multiple executions of the error rate test. 

INPUT FORMAT: 



Input the test name? 
? 

CLEAR LOGS 

Do you want to clear 
all the logs (ALL) or 
just the ERT log (ERT)? 
? [ALL] or [ERT] 

OUTPUT FORMAT: 

CLEAR LOGS UTILITY COMPLETED 



If ERT is specified, only the 
ERT log will be cleared. 
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2-7. D1AC 

INTERNAL DIAGNOSTIC TEST 

This test will invoke diagnostic tests which reside in the 
drive. The specific tests are unique to each type of drive and 
are described in the support documentation for each type of 
drive. Por a diagnostic to be executed, the unit addressed must 
be the devices controller <UNIT=15). Due to the nature of some 
of the diagnostic tests, it is recommended that the unit is set 
to 15 before running each diagnostic. Various macro-diagnostics 
involve extensive device verification which re-establish default 
parameters such as unit and volume. 

INPUT FORMAT: 

Input test name? 

? 

DIAG 

Input diagnostic number <« 127 Consult service manual for 

1 valid entries. 

[nnnn] 

Input the loop count <« 65535 

? 

[nnnn] 

OUTPUT FORMAT: 

Diagnostic f ■ nnnn 

Number of times to loop - nnnn 

INTERNAL DIAGNOSTIC If diagnostic passed. 

TEST COMPLETED 
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2-8. ERRSl'M 

READ ERROR SUMMARY UTILITY 

This utility will print out the error summary which is a list of 
all errors which have occurred on the drive. The list can iden- 
tify all the different types of errors which can occur in the 
drive. The list is a history of all errors which have occurred 
since the last power on sequence or the last execution of the 
self test diagnostic which is internal to the drive. The drive 
keeps a record of the last four error summarys on the disc main- 
tenance tracks. Error summarys provide useful information for 
difficult intermittent problems. 

The significance for each error is described in the support doc- 
umentation for the particular drive. 

INPUT FORMAT: 



Input the test name? 

ERRSUM 

Do you want the previous (P) or 

current (C) results? 

■> 

[P] or [C] 

OUTPUT FORMAT: 

CURRENT ERROR SUMMARY 

CURRENT error numbers : 

HHH HHH HHH HHH HHH HHH HHH HHH 
HHH HHH HHH HHH HHH HHH HHH HHH 
Until all errors are displayed . 

CURRENT - 1 error numbers: 

CURRENT - 2 error numbers : 

CURRENT - 3 error numbers : 

READ ERROR SUMMARY 
UTILITY COMPLETED 



[P] prints the last four 
error summaries. 

[C] prints the most current 
error summary. 



If [C] is input, only the 
current error summary is 
printed . 

If any errors are in the 
summary . 



If [P] is input, all 4 
error summaries are printed. 
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2-9. ERT LOG 

READ ERROR RATE TEST DATA ERROR LOG UTILITY 

This utility allows the user to access the error rate log which 
contains an accumulation of all read errors which were found 
during a read only or write-then-read error rate test . 

Error rate test errors are accumulated until the log is cleared 
by a user with the clear logs utility. 

Error rate test errors are accumulated and cataloged by head 
number. 

INPUT FORMAT: 

Input the test name? 

1 

ERT LOG 

Input the head number? 
? 

[nnnn] or [ALL] 
OUTPUT FORMAT: 



Input for disc only. 



Head # = nnnn 

No. of sectors read ■ nnnn 

No. of ECC correctable errors 

on this head = nnnn 

No. of ECC uncorrectable errors 

on this head = nnnn 

No. of error addresses 

logged = nnnn 

ERT LOG HEADER 



Output for disc unit. 



I OF BLOCKS ACCESSED = nnnnnnnn 

# OF BLOCKS CORRECTED = nnn 

due to Permanent s = nnn 
due to Transients = nnn 

# OF UNCORRECTABLE BLOCKS = nnnn 

# OF UNLOCATABLE BLOCKS = nnnn 



Output for tape unit . 



Logical Addresses 



Errors 



nnnnnn UNLOCATABLE 

nnnnnn UNCORRECTABLE 

nnnnnn UNLOCATABLE 

Until the last error is displayed. 
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The following data is 
repeated for every error 
which has occurred 
since the last [CLEAR LOGS] 
command or FORMAT was sent . 



ERROR INFO =nnnnnnnn Loop* - nn 





CURRENT 


CURRENT 




PHYSICAL 


LOGICAL 


CYL 


nnnn 


nnnn 


HEAD 


nnnn 


nnnn 


SECT 


nnnn 


nnnn 



ERROR BEGINS AT BYTE = nnnn 
Was : nnnnnnnn nnnnnnnn nnnnnnnn 
Map: 

READ ERT DATA ERROR LOG 
UTILITY COMPLETED 



The error information byte is 
binary with Bit on the right 
and Bit 7 on the left. 

Occurrence count if the number 
of times an error occurred at 
that address since last 
[CLEAR LOGS] command. 
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2-10. EXIT 

EXIT PROGRAM 

This command terminates the external exerciser program. 
EXIT can be entered after any prompt and at any time 
during any input sequence. 

INPUT FORMAT: 

Input the test name? 
? 

EXIT 

OUTPUT PORMAT 

YOU HAVE CHOSEN TO EXIT 

THE PROGRAM WILL NOW HALT 
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'.-tt FAULT LOG 

READ DRIVE FAULT LOG UTILITY 

This utility allows the user to access the drive fault log which 
contains an accumulation of the drive faults which occurred on 
that particular drive over a period of time since the last time 
the logs were cleared. 

Drive faults are accumulated in the drive until the log is 
cleared by a user with the CLEAR LOGS utility. The fault log 
resides on the disc maintenance tracks. 

INPUT FORMAT: 

Input the test name? 
•> 

FAULT LOG 
OUTPUT FORMAT: 



If no faults since last 
[CLEAR LOGS] command. 



No drive faults to report 



Number of faults logged = nnnn 



CURRENT TARGET 

LOGICAL LOGICAL 
CYL nnnn* nnnn 
HEAD nnnn nnnn 
SECT nnnn nnnn 

Microprocessor fault reg=% nnn 
DERROR halting process = nnnnn 

or 
TERROR halting process = nnnnn 



If faults occurred since last 
[CLEAR LOGS] command. 

Address location when fault 
occurred. Star indicates a 
physical cylinder 

Microprocessor fault t 

Error # 

% indicates an octal number. 



A-19 



CS80 Device Diagnostic 

2-12. HELP 

PRINT HELP FILE 

This command prints out the valid command names with their short 
definitions. 

INPUT FORMAT: 

Input test name? 

HELP 

OUTPUT FORMAT: 

CANCEL - cancels the previous command 

CERT - certify tape 

CHANNEL - HP-IB channel test 

CICLEAR - channel independent clear 

CLEAR LOGS - clear internal logs 

DIAG - internal diagnostic test 

ERT LOG - print ERROR RATE TEST log 

EXIT - either stops the program or prompts for test name 

FAULTLOG - print drive fault log 

HELP - prints this file over 

INIT MEDIA - initializes the selected device's media 

PRESET - preset drive 

REQSTAT - request status message 

REV - print revision data 

RF SECTOR - read full sector 

RO ERT - read only error rate test 

RUN LOG - print run time data error log 

SDCLEAR - selected device clear 

SENSE - print sensor data 

SPARE - spare block 

TABLES - print internal table data 

UNIT - set unit 

UNLOAD - unload tape 

USE LOG - print tape use log 

WRITE FM - write end of file mark on tape 

WRT ERT - write then read ERT 
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2-13. INIT MEDIA 

DISC/TAPE UTILITY 

This utility allows a user to format the disc's media. It will 
also allow the user to clear the spare table of all sectors 
which were not spared by the factory, or allow the user to re- 
tain all spares. An INIT MEDIA erases all primary (factory) 
spares. After an initializing format, it is mandatory that an 
extensive error rate test is run and that all questionable 
sectors be spared. INIT MEDIA destroys all user data. 



INPUT FORMAT: 



For disc only. 



Input the test name? 

7 

INIT MEDIA 

INIT MEDIA will destroy all current 

data. 

Should this utility continue? 



[YES] or [NO] 

Do you want a INIT MEDIA which: 
I = initializes the spare table 
P = retains only primary spares 

or 
B = retains primary and 
secondary spares? 
7 

[I] or [P] or [B] 

Input the interleave value <= 32 

7 

[ nnnn ] 

OUTPUT FORMAT: 



[NO] stops this utility. 



Primary spares are factory 
spares . 

Secondary spares are 
field spares. 



Interleave described in 
Service Manual. 



INIT MEDIA COMMAND UTILITY 

This utility may take several 
minutes to complete. 

INIT MEDIA COMMAND UTILITY COMPLETED 
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This utility may also be used as an initialization routine for 
tape unit media. 



INPUT FORMAT: 

Input the test name? 
1 

INIT MEDIA 

This test may destroy data. 

Do you wish to continue? 

? 

[YES] or [NO] 

Was this tape previously 

certified? 'YES', 'NO', OR '??' 

i 

[YES] or [NO] or [??] 

Do you want to : 

C - convert jump spares to skip 

OR 
I - just initialize the spare 
table 
? 

[C] or [I] 
Do you want to: 
C - certify test 

OR 
I - just initialize the spare 
table 
i 

[C] or [I] 

This ..program will attempt to 
read the run log to verify 
whether the tape was certified 
or not 
This may take a few minutes ! ! 

Attempting to read the run log 
FAILED, Do you want to try 
again? 

[YES] or [NO] 

OUTPUT FORMAT: 

INIT MEDIA UTILITY 
UTILITY COMPLETED 



For Tape only. 



If [YES] was entered. 



If [NO] was entered. 



If [??] was entered. 



If unsuccessful. 



[YES] will try again. 



If successful. 



A-22 



CS80 Device Diagnostic 



2-14. PRESET 

PRESET DRIVE UTILITY 



This command puts the CS/80 device in a known state for the 
exerciser. All required logging is performed, and an automatic 
head alignment takes place on discs which utilize this feature. 



INPUT FORMAT: 

Input test name? 
1 

PRESET 

OUTPUT FORMAT: 

PRESET DRIVE UTILITY COMPLETED 
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2-15. REQSTAT 

REQUEST STATUS 

This utility allows the device to send back status messages to 
the external exerciser. The status message consists of an iden- 
tification field, an error reporting field, and a parameter 
field. The identification field shows the unit and volume cur- 
rently addressed and identifies if any other units need service. 
The error field shows four types of errors: reject errors, fault 
errors, access errors, and information errors. Reject errors 
indicate an illegal interaction with the device such as an op- 
code error. Reject errors result when an exerciser command being 
sent is not recognized by the device. Consult the service manual 
for the device being diagnosed for a list of CS/80 external ex- 
erciser commands which it supports. Fault errors indicate that 
diagnostic hardware failure information is available. Access 
errors indicate media abscence or formatting problems or opera- 
tor intervention. Information errors indicate potential problems 
or performance irregularities have occurred within the device. 

INPUT FORMAT: 

Input the test name? 

REQSTAT 

OUTPUT FORMAT: 

STATUS MSG FOLLOWS: 

"•IDENTIFICATION FIELD* • 

Unit = nnnn Volume = nnnn 

No Units Require Service 

OR 
Unit nnnn Requires Service 

••REJECT ERRORS FIELD* • 

Channel Parity Error 
Illegal Opcode 

Illegal Volume or Unit number 
Address Bounds Error 
Parameter Bounds Error 
Illegal Parameter 
Message Sequence Error 
Message Length Error 

••FAULT ERRORS FIELD" 
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Cross Unit Error during Copy Data 
Unit which had errors are: 
Unit = nnnn 
Unit = nnnn 
Controller Fault 
Unit Fault 

Hardware Failed Diagnostic 
Part number* nnnn failed 
Test Error number= nnnn returned 
Drive Error number= nnnn returned 
Release Required for Operator Maintenance 

before command can be executed 
Release Required for Diagnostics Maintenance 

before command can be executed 
Release Required for Internal Maintenance 

before command can be executed 
Power Failed or Drive just Powered On 
Auto Release has been completed / Retransmit command 

••ACCESS ERRORS FIELD** 

Illegal Parallel Operation 

Uninitialized Media 

No more spares available 

drive is not ready 

Volume is Write Protected 

No Data Found 

Unrecoverable Data Overflow 

Unrecoverable Data, Address of bad data follows: 

Block Address « nnnn 
OR 

Vector Address 
cyl « nnnn 

head ■ nnnn 

sect = nnnn 
End of File encountered 
End of Volume encountered 

••INFORMATION ERRORS FIELD** 

Operator is Requesting Release 

Release Requested for a Diagnostic Result 

Release Requested for Internal Maintenance 

Media Wear 

Latency Induced for Data Overun 

Auto Sparing Invoked by the Unit 

Recoverable Data Overflow 

Marginal Data encountered, data was 

recovered but with much 

difficulty. Address of marginal 

data is: 

Block Address = nnnn 
OR 
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Vector Address 

cyl = nnnn 

head * nnnn 

sect * nnnn 

Recoverable Data — but a latency 

was induced in order to recover 
the data. Address of the recovered 
block is: 

Block Address = nnnn 

OR 

Vector Address 

cyl = nnnn 

head « nnnn 

sect = nnnn 

Maintenance Track Overflow 

New Target Address is : 
Block Address « nnnn 

OR 
Vector Address 

cyl x nnnn 

head ■ nnnn 

sect « nnnn 
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2-16. REV 

READ REVISION NUMBER UTILITY 

This utility will read the revision numbers of the printed cir- 
cuit boards and of the firmware installed on the drive under 
test. 

INPUT FORMAT: 



Input 
? 

REV 


the test name? 


OUTPUT 


FORMAT : 


Part 


Revision 



1 
2 


nn - r 
nn - r 
nn - r 



If test completes 

(nn) = revision number 
for part . 

(r) = artwork revision 
number. 



READ REVISION NUMBER 
UTILITY COMPLETED 
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2-17. RF SECTOR 

READ FULL SECTOR UTILITY 

This utility will allow a user to read a full sector from any 
valid logical address in the disc. This means that a user can 
look at data contained in the header of a sector as well as the 
CRC and ECC data contained in the trailing end of the sector. 

INPUT FORMAT: 

Input the test name? 
7 

RF SECTOR 

# of sectors to read <= 32767 

9 

[ nnnn ] 

Enter the address change or just 

carriage return to keep 

the current values . 



Cylinder address = xxxx? 
7 

[nnnn] 

Head address = xxxx? 

7 

[nnnn] 

Sector address = xxxx? 

i 

[nnnn] 

OUTPUT FORMAT: 

RF SECTOR 

Status ■ nnnn 

Physical sector t = nnnn 

Head # = nnnn 

Cylinder # = nnnn 

Physical Spare Sector = nnnn 

Data follows: 

1 HH HH HH HH HH HH HH HH 

9 HH HH HH HH HH HH HH HH 

17 HH HH HH HH HH HH HH HH 



(xxxx) is the current address 
value stored in the drive. 



2K9 HH HH HH HH HH HH HH HH 
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CRC « nnnnnnnn nnnnnnnn 

ECC = nnnnnnnn nnnnnnnn nnnnnnnn nnnnnnnn nnnnnnnn 

RF SECTOR COMPLETED 
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2-18. ROERT 

READ ONLY ERROR RATE TEST 

There are two types of read only error rate tests. The first 
type allows the user to specify an address which it will use to 
start a sequential read in an attempt to locate any read errors . 
The second is a random pattern search which uses a valid random 
address and a random length in an attempt to locate any read 
errors . 

INPUT FORMAT: 

Input the test name? 
? 

RO ERT 

Input the loop count ; 
1 <« count <=25«l or INF 
? 

[nnnn] 

Do you want a random read only For disc unit . 
ERT? 
? 

[YES] or [NO] 

Enter address changes or just Address changes are for non- 
carriage return to keep random ERT only 
the current values . 

Cylinder address = xxxx 

? 

[nnnn] [nnnn] represents the new 

address . 
Head address - xxxx 
? 
[nnnn] 

Sector address = xxxx 

? 

[nnnn] 

Do you want to test the 

V = volume, H = head, T = track 

C = cylinder, or S = sector? 

9 

[V] or [H] or [T] or [C] or [S] 
Do you want to use head offset? 
? 

[YES] or [NO] 

Input offset -127<=offset<=127 Only if offset is desired. 
? 

[nnnn] 

Output formats are: 

ALL = print all information 
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ADD = print just error address 
LOG = log in error rate log 
Enter the format? 
? 

[ALL] or [ADD] or [LOG] 

Do you want to test the 
C = current address 
S - specified track 
E = entire tape 
1 

[C] or [S] or [E] 
Input the track number 
7 

[nnn] 

OUTPUT FORMAT: 

READ ONLY ERT TEST COMPLETED 



For tape unit . 



If [S] was entered. 



The following data is 
repeated for every error 
which has occurred 
since the last [CLEAR LOGS] 
command was sent . 



ERROR INFO =nnnnnnnn Loop* = nn 

CURRENT CURRENT 

PHYSICAL LOGICAL 
CYL nnnn nnnn 
HEAD nnnn nnnn 
SECT nnnn nnnn 

ERROR BEGINS AT BYTE - nnnn 
Was : nnnnnnnn nnnnnnnn nnnnnnnn 
Map: 



The error information byte is 
binary with Bit on the right 
and Bit 7 on the left. 

Occurrence count if the number 
of times an error occurred at 
that address since last 
[CLEAR LOGS] command. 
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2-19. RUN LOG 

READ RUN TIME DATA ERROR LOG UTILITY 

This utility allows the user to access the run log which con- 
tains an accumulation of the run time data errors which the 
drive has logged. Run time data errors are accumulated and log- 
ged by the disc automatically. 

Run time data errors are accumulated in the drive's run time log 
during normal run time activity and are cleared by the user with 
the clear log utility. 

The run time data errors are accumulated and cataloged by head 
number. 

INPUT FORMAT: 

Input the test name? 

RUN LOG 



Input the head number? 
? 

[nnnn] or [ALL] 



For disc unit. 



OUTPUT FORMAT: 



Head I « nnnn 

No. of sectors read = nnnn 

No. of ECC correctable errors 

on this head = nnnn 

No. of ECC uncorrectable errors 

on this head = nnnn 

No. of error addresses 

logged = nnnn 



The following data is repeated 
for every error that occurred 
since the last [CLEAR LOGS] 
command was sent . 



# of UNCORRECTABLE BLOCKS = nnnn 

# of UNLOCATABLE BLOCKS - nnnn 
CERTIFICATION: (NOT) certified 

READ RUN TIME DATA ERROR LOG 
UTILITY COMPLETED 



For tape unit . 

(NOT) appears if the tape 
has not been certified. 



ERROR INFO =nnnnnnnn Loop* = nn 



The following data is 
repeated for every error 
which has occurred 
since the last [CLEAR LOGS] 
command was sent. 
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CYL 

HEAD 

SECT 



CURRENT CURRENT 
PHYSICAL LOGICAL 



nnnn 
nnnn 
nnnn 



nnnn 
nnnn 

nnnn 



ERROR BEGINS AT BYTE = nnnn 
Was : nnnnnnnn nnnnnnnn nnnnnnnn 
Hap: 



The error information byte is 
binary with Bit on the right 
and Bit 7 on the left. 

Occurrence count if the number 
of times an error occurred at 
that address since last 
[CLEAR LOGS] command. 
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Z-20. SDCLEAR 

SELECTED DEVICE CLEAR UTILITY 

This command clears the device on the channel which is presently 
addressed. 

INPUT FORMAT: 

Input the test name? 
? 

SDCLEAR 

OUTPUT FORMAT: 

SELECTED DEVICE CLEAR 

UTILITY COMPLETED 
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2-21. SENSE 

READ SENSORS UTILITY 

This test is unique to 793X type drives. It's purpose is to 
report the value of the temperature and pressure sensors in the 
drive. 

INPUT FORMAT: 

Input test name? 

SENSE 

OUTPUT FORMAT: 

Blower pressure = GOOD or BAD 
Filter pressure = GOOD or BAD 
Exhaust air temp = nn +-3deg C 
Actuator coil temp = nn +-3deg C 

SENSE UTILITY COMPLETED 
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2-21. SPARE 

SPARE BLOCK UTILITY 

This utility allows the user to spare a block or sector to an 
address which is reserved for sparing. It allows for the user 
the option to retain or not to retain the data from the block or 
sector which is being spared. 

INPUT FORMAT: 

Input the test name? 



SPARE 

Do you want to retain the data? 

7 

[YES] or [NO] 

Do you wish block 'B' or three 

vector 'V addressing? 

7 

[B] or [V] 

Enter a new block address or 
enter just a carriage return to 
keep the current block address 

Input the block address? 
7 

[nnnn] or [return] 

Enter address changes or just 
carriage return to keep 
the current values . 



Cylinder address 
i 



xxxx? 
[nnnn] or [return] 
Head address = xxxx 
[nnnn] or [retur.i] 

Sector address = xxxx 

? 

[nnnn] or [return] 

Do you want S (Skip) or J (Jump) 
sparing? 

[S] or [J] 

Input the block address 

7 

[nnnn] 



For disc unit . 



If [B] was entered. 



If [V] was entered. 



For tape unit. 
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OUTPUT FORMAT: 

SPARE BLOCK COMMAND SENT 

BLOCK= nnnn If [B] was entered. 

CYL= xxxx HEAD= xxxx SECT=xxxx If [V] was entered. 

If [S] was entered. 

If [J] was entered. 
SPARE BLOCK UTILITY COMPLETED 
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2-23. TABLES 

READ DRIVE TABIDS UTILITY 

This utility will print out the various information tables which 
reside in the drive. 

INPUT FORMAT: 

Input test name? 

1 

TABLES 

Drive table numbers are: (For disc) 



1 « Spare track table 

2 « Head value table 

3 * Configuration table 

Drive table numbers are: (For tape) 

10 = Manufacture's table 

11 » Tape spare table 

Input drive table number? 

? 

[nnnn] 

OUTPUT FORMAT: 

SPARE TRACK TABLE 

Head number - nnnn 

No. of spare operations = nnnn 

# of tracks used = nnnn 

I of logical tracks spared ■ nnnn 

READ DRIVE TABLES 
UTILITY COMPLETED 



OUTPUT FORMAT OF THE HEAD VALUE TABLE 
Alignment values for head # nnnn 



All Drives 

793X 

793X 



7908/11/12 (with tape) 
7908/11/12 (with tape) 



This is output for each head . 



OD = nnnn 
MI-OD = nnnn 
MI = nnnn 
ID-MI = nnnn 
ID = nnnn 

Skew values for head # nnnn 
OD = nnnn 
MI-OD = nnnn 
MI = nnnn 



OD = Outside Diameter 

MI-OD = Middle to Outside Dia. 

MI = Middle Diameter 

ID-MI = Inside Dia. to Middle 

ID = Inside Diameter 
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ID-MI = nnnn 
ID = nnnn 

Current Cylinder Offset Table 

Head = nnnn nnnn = calculated offset for 

Head 1 = nnnn all heads in drive. 

Head 2 = nnnn 

Until all heads are displayed. 

READ DRIVE TABLES 
UTILITY COMPLETED 

OUTPUT FORMAT OF THE CONFIGURATION TABLE 

Current Configuration Table If test completed. 

Transfer length = nnnn 

Burst length = nnnn 

RPS window = nnnn 

RPS advance = nnnn 

Retry time = nnnn 

Status mask = 8 bit binary field 

Set release S bit = ON/OFF 

Set release T bit ■ ON/OFF 

Optious flag - 8 bit binary field 

Return addressing mode = BLOCK OR VECTOR 

READ DRIVE TABLES 
UTILITY COMPLETED 



OUTPUT FORMAT OF THE MANUFACTURER'S TABLE 

Cartridge type =xxxxxxx 
Number of user blocks = nnnn 
Copyright notice 

FORMAT [date] 

MINN. MINING & MFG. CO. 

Manufacturer's code * nnnnnn 
Date code = nnnnnnnnnn 

READ DRIVE TABLES 
UTILITY COMPLETED 

OUTPUT FORMAT OF THE TAPE SPARE TABLE 

1 BLOCK # = nnnn 
TRACK # = nn 

2 BLOCK # = nnnn 
TRACK # = nn 
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Until all spare blocks 
are displayed . 

READ DRIVE TABLES 
UTILITY COMPLETED 



A-«0 



CS80 Device Diagnostic 



2-24. UNIT 
SET UNIT NUMBER UTILITY 



This utility allows a user to use the Command Set '80 complemen- 
tary command to set the unit number in the drive. This command 
is required for multiunit drives so that the user can specify 
the unit to test . 



Input the test name? 
UNIT 

Input the unit number <= 15 

? 

[nnnn] 

OUTPUT FORMAT: 

UNIT SELECTED = nnnn 

SET UNIT NUMBER 
UTILITY COMPLETED 
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2-25. UNLOAD 

UNLOAD TAPE CARTRIDGE 

This coanand performs the save function as pressing the unload 
button on the front panel of the device. 

INPUT FORMAT: 

Input the test name? 

T 
UNLOAD 

OUTPUT FORMAT: 

UNLOAD UTILITY COMPLETED 
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2-26. USE LOG 

The use log provides the tape cartridge use count (number of 
times the tape has been inserted) and the number of blocks which 
have been accessed on the particular cartridge. Note: The USE 
LOG command cannot increment use number when the cartridge that 
is inserted is "write protected". 

INPUT FORMAT: 

Input the test name? 
? 

USE LOG 

OUTPUT FORMAT: 

USE COUNT = nnnn 
# OF BLOCKS 
ACCESSED = nnnnnnnnn 

READ TAPE USE LOG 

UTILITY COMPLETED 
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Z-IT. WRITE FM 

WRITE FILEMARK UTILITY 

This command writes an End Of File (EOF) mark at the current 
tape position. 

INPUT FORMAT: 

Input the test name? 

? 

WRITE FM 

OUTPUT FORMAT: 

WRITE FILE MARK 
UTILITY COMPLETED 
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2-28. WTRERT 

WRITE THEN READ ERROR RATE TEST 

There are three types of write then read error rate tests. The 
first allows the user to input a starting point address, the 
second uses a random address and random length, and the third is 
a combination of the first and second types. 

INPUT FORMAT: 

Input the test name? 

WTR ERT 

Input the loop count; 

1 <= count <=254 or INF 

•> 

[nnnn] 

This test will destroy current 

data. 

Should it continue? 

7 

[YES] or [NO] 

Types of Write Then Read ERT's: For disc unit. 

PT « Pattern test ERT. 

RN = Random address ERT. 

SH = Short ERT. 

Enter the type of test? 

? 

[PT] or [RN] or [SH] 

Enter address changes or just If [FT] was entered. 

carriage return to keep 

the current values. 

Cylinder address = xxxx 

? 

[nnnn] 

Head address - xxxx 

[nnnn] 

Sector address = xxxx 

? 

[nnnn] 
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Do you want to test the 

V « volume, H = head, T = track 

C ■ cylinder, or S = sector? 

? 

[V] or [H] or [T] or [C] or [S] 

Do you want to use head offset? 

? 

[YES] or [HO] 

Input offset -127<-offset<=127 

1 

[nnnn] 

Do you want to test the 

C « current address 

S ■ specified track, 

E "= entire tape 

? 

[C] or [S] or [EJ 

Input the track number 

? 

[nnn] 

Sources of the bit pattern are: 
PT - EOT internal Pattern Table 
RH ■ ERT generates Random 
pattern table 
UP » User inputs pattern table 

Enter the pattern source? 

? 

[PTJ or [RH] or [UP] 

Input a hexadecimal pattern of 

up to 8 hex digits. 

? 

[HHHHHHHH] 

Output formats are: 

ALL « print all information 

ADD » print Just error address 

LOG - log in error rate log 

Enter the format? 

? 

[ALL] or [ADD) or [LOG] 

OUTPUT FORMAT: 

WRITE THEN READ ERT 
TEST COMPLETED 



If [YES] was entered. 
For tape unit. 

If [S] was entered. 



The following data is 
repeated for every error 
which has occurred 
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since the last [CLEAR LOGS] 
command was sent . 



ERROR INFO =nnnnnnnn Loop* = nn 

CURRENT CURRENT 

PHYSICAL LOGICAL 
CYL nnnn nnnn 
HEAD nnnn nnnn 
SECT nnnn nnnn 

ERROR BEGINS AT BYTE = nnnn 
Was: nnnnnnnn nnnnnnnn nnnnnnnn 
Map: • • • 



The error information byte is 
binary with Bit on the right 
and Bit 7 on the left. 

Occurrence count if the number 
of times an error occurred at 
that address since last 
[CLEAR LOGS] command. 
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EXTERNAL EXERCISER 
SECTION III. OPERATOR DESIGNED CS/80 COMMANDS 



This section of the External Exerciser is not implemented in 
this diagnostic since a simular capability exists in the 
SLEUTHSM utility. Also the CS/80 offline diagnostic sections H 
and 5 perform tests simular to this External Exerciser section. 
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